Skip to content

netbones/honeymoon-suites

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

38 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kevin Parissien & The Honeymoon Suites Fan Site

A comprehensive fan site celebrating Kevin Parissien and The Honeymoon Suites, the legendary South African glamrock band from the 1990s Cape Town music scene.

🎸 Features

Main Site (index.html)

  • Interactive music player with playlist functionality
  • Band member profiles and history
  • Album showcase with real artwork
  • Responsive design with glamrock aesthetics

Fan Gallery (fan-gallery.html)

  • Photo galleries with real band images
  • Interactive elements (costume try-on, fan art generator)
  • Fan memories and quotes
  • Concert timeline and venue history

Extended Gallery (gallery-extended.html)

  • Deep dive into band history
  • Album details and track listings
  • Rare photos and behind-the-scenes content
  • Historical context of the 1990s Cape Town scene

Greatest Hits (greatest-hits.html)

  • Curated collection of their best tracks
  • Interactive track listing with hover effects
  • Album artwork and production credits
  • Comprehensive liner notes

Audio Testing (audio-options-test.html, enhanced-audio-test.html)

  • YouTube API integration for real music streaming
  • Bandcamp embed testing
  • Hybrid streaming approach with fallbacks
  • Developer tools for testing audio functionality

🎨 Architecture

CSS Organization (css/)

  • common.css - Shared styles, glamrock theme, navigation
  • music-player.css - Music player, vinyl animations, waveforms
  • gallery.css - Photo galleries, lightbox, interactive elements
  • test-lab.css - Development and testing interface styles

JavaScript Organization (js/)

  • common.js - Shared functionality, smooth scrolling, animations
  • music-player.js - Music player logic, playlist management
  • gallery.js - Gallery interactions, lightbox, filtering
  • test-lab.js - Audio testing, YouTube API integration

Configuration System

  • config.example.js - Template for API keys and settings
  • config.js - Your actual configuration (create from template)
  • Automatic detection - Falls back gracefully if config missing

Assets (assets/)

  • 5star.jpeg - Five Star album cover
  • firstalbum.jpeg - Greatest Hits album cover

πŸš€ Quick Start

Basic Setup (No API Required)

# Download or clone the repository
# Open index.html in any modern web browser
# Enjoy the complete fan site experience

Advanced Setup (YouTube Integration)

# Copy configuration template
cp config.example.js config.js

# Edit config.js and add your YouTube Data API v3 key
# Get API key from: https://console.cloud.google.com/

See SETUP.md for detailed instructions

πŸ›‘οΈ Security

  • No hardcoded API keys in source code
  • Template-based configuration system
  • Automatic config detection with graceful fallbacks
  • Domain restrictions recommended for YouTube API
  • Rate limiting and quota management
  • See SECURITY.md for detailed guidelines

🎡 Music Integration

Streaming Sources

  1. YouTube API - Primary source with search functionality
  2. Bandcamp - Official releases and high-quality audio
  3. Demo Mode - Simulated playback for development

Configuration Integration

  • Automatic API key loading from config.js
  • Fallback to manual entry if config unavailable
  • Real-time status indicators showing config state
  • Error handling for missing or invalid keys

Supported Features

  • Track search and automatic discovery
  • Playlist management with shuffle and repeat
  • Progress tracking and seeking
  • Volume control and audio visualization
  • Fallback systems for unavailable tracks

πŸ“± Responsive Design

  • Mobile-first approach
  • Bootstrap 5 grid system
  • Touch-friendly interactions
  • Optimized images and assets
  • Progressive enhancement

🎨 Design Philosophy

Glamrock Aesthetic

  • Neon color schemes (red, pink, purple, gold)
  • Gradient animations and text effects
  • Vintage frames and polaroid styling
  • Floating elements and interactive animations
  • Professional typography with dramatic flair

User Experience

  • Intuitive navigation between sections
  • Smooth transitions and hover effects
  • Keyboard shortcuts for music player
  • Accessibility considerations
  • Fast loading with optimized assets

πŸ” Browser Support

  • Modern browsers (Chrome, Firefox, Safari, Edge)
  • Mobile browsers (iOS Safari, Chrome Mobile)
  • Progressive enhancement for older browsers
  • Graceful degradation for missing features

πŸ“„ File Structure

β”œβ”€β”€ index.html                 # Main fan site (home page)
β”œβ”€β”€ fan-gallery.html          # Photo gallery with interactive elements
β”œβ”€β”€ gallery-extended.html     # Extended gallery with deep-dive content
β”œβ”€β”€ greatest-hits.html        # Greatest hits album showcase
β”œβ”€β”€ audio-options-test.html   # Audio testing lab with YouTube API
β”œβ”€β”€ enhanced-audio-test.html  # Enhanced audio testing interface
β”œβ”€β”€ css/
β”‚   β”œβ”€β”€ common.css           # Shared styles (glamrock theme, navigation)
β”‚   β”œβ”€β”€ music-player.css     # Music player, vinyl animations, waveforms
β”‚   β”œβ”€β”€ gallery.css          # Gallery styles, photo cards, lightbox
β”‚   └── test-lab.css         # Testing interface styles, debug console
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ common.js            # Shared functionality (animations, lightbox)
β”‚   β”œβ”€β”€ music-player.js      # Music player logic and playlist management
β”‚   β”œβ”€β”€ gallery.js           # Gallery interactions and filtering
β”‚   └── test-lab.js          # Audio testing and YouTube API integration
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ 5star.jpeg           # Five Star album cover (official artwork)
β”‚   └── firstalbum.jpeg      # Greatest Hits album cover
β”œβ”€β”€ config.example.js        # Configuration template for API keys
β”œβ”€β”€ config.js               # Your configuration file (create from template)
β”œβ”€β”€ .env.example            # Environment template (for reference)
β”œβ”€β”€ .gitignore              # Git ignore rules (protects sensitive files)
β”œβ”€β”€ SECURITY.md             # Security guidelines and best practices
β”œβ”€β”€ SETUP.md                # Detailed setup instructions
β”œβ”€β”€ image-urls.md           # Documentation of image sources
└── README.md               # This documentation file

πŸš€ Deployment

Static Hosting Options

  • GitHub Pages - Free hosting for static sites
  • Netlify - Advanced features and CDN
  • Vercel - Optimized for modern web apps
  • Traditional web hosting - Any static file server

Pre-Deployment Checklist

  1. Create config.js from template with your API keys
  2. Test all functionality locally
  3. Verify API key restrictions in Google Cloud Console
  4. Check .gitignore to ensure no sensitive files are committed

Deployment Steps

  1. Upload all files to your hosting provider
  2. Ensure proper MIME types for CSS/JS files:
    • .css files: text/css
    • .js files: application/javascript
    • .jpeg/.jpg files: image/jpeg
  3. Configure domain restrictions for API keys in Google Cloud Console
  4. Test all functionality in production environment
  5. Monitor API usage and quotas

Post-Deployment Configuration

  • Domain Restrictions: Limit API keys to your production domain
  • HTTPS: Ensure site is served over HTTPS for security
  • CDN: Consider using a CDN for better performance
  • Monitoring: Set up alerts for API quota usage

🎯 Future Enhancements

  • Real audio streaming with proper licensing
  • User comments and fan submissions
  • Social media integration
  • Newsletter signup and fan club features
  • Merchandise store integration
  • Concert booking and event listings
  • Multi-language support

πŸ“ž Support

For technical issues or questions about The Honeymoon Suites:

  • Check the browser console for error messages
  • Verify API key configuration in config.js
  • Review security guidelines in SECURITY.md
  • Follow detailed setup in SETUP.md
  • Test with different browsers and devices

🎡 About The Honeymoon Suites

The Honeymoon Suites were a legendary South African glamrock band from Cape Town's vibrant 1990s music scene. Led by charismatic vocalist Kevin Parissien, the band was known for their theatrical performances, elaborate costumes, and unique blend of glamrock and lounge music. Their album "Five Star" remains a classic of South African alternative rock.

Band Members:

  • Kevin Parissien - Lead Vocals
  • Julie Uranium - Keyboards, Percussion, Vocals
  • Bood Carver - Bass, Guitar, Vocals
  • Jamie Cloete - Guitar, Bass, Harmonica
  • Eastern North - Drums, Vocals
  • Douglas Armstrong - Trumpet, Percussion, Vocals
  • Ampie Stander - Trombone, Percussion, Vocals
  • Chaz Singer - Saxophone, Violins

"Free your ass and your mind will follow" - Kevin Parissien

About

honeymoon suites fan site

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors