A dynamic, single-page website for Baltimore-based DJ Nerva that creates a unique visual experience on each page load through randomized hero images, color schemes, and taglines.
- Dynamic Hero Images: Randomized AI-generated backgrounds from 13 themed collections
- Adaptive Color Theming: Automatic color palette extraction and application
- Random Taglines: Rotating collection of 18 DJ-themed slogans
- Responsive Design: Optimized for desktop and mobile devices
- Music Integration: Embedded Mixcloud players showcasing DJ sets
- Event Calendar: Upcoming performances and bookings
- Equipment Showcase: Available gear for event bookings
- SEO Optimized: Complete meta tags, Open Graph, and Twitter Cards
- Clone the repository
- Open
index.htmlin a web browser - Click the "Remix" button to see different visual combinations
Website/
βββ index.html # Main HTML file
βββ main.js # Core JavaScript functionality
βββ simplified-style.css # Styling and responsive design
βββ image_data.json # Generated image manifest with color data
βββ taglines.json # Collection of random taglines
βββ build-image-manifest.js # Node.js script for image processing
βββ splash-images/ # Hero image collections (1-13 folders)
β βββ 1/ # Desktop and mobile images
β βββ 2/
β βββ ...
βββ icons/ # UI icons and buttons
βββ sound/ # Audio assets
The main script handles:
- Fetching image and tagline data from JSON files
- Random selection of visual elements
- DOM manipulation for dynamic content
- Fallback mechanisms for error handling
- Cache-busting for image updates
Node.js script that:
- Processes all images in splash-images folders
- Extracts color palettes using Vibrant library
- Generates
image_data.jsonmanifest - Ensures WCAG contrast compliance
- Maintains brand consistency
image_data.json - Contains 13 image sets with:
{
"folder": "1",
"desktop": "image-filename.png",
"mobile": "mobile-filename.png",
"primaryColor": "#6625d9",
"secondaryColor": "#0c1762",
"accentColor": "#73baee"
}taglines.json - Array of rotating taglines:
[
"Baltimore Beats, Global Heat.",
"Jungle-Fueled. House-Powered.",
"High-BPM Heartbeat of Charm City."
]- Users can click "Remix" to refresh and get new visual combinations
- Each page load presents a unique aesthetic while maintaining brand consistency
- Mirrors DJ culture of remixing - same content, different presentation
- Desktop and mobile-optimized images
- Adaptive layouts for all screen sizes
- Touch-friendly navigation elements
- Hero Section: Dynamic background, logo, random tagline, CTA
- About: DJ biography and musical style description
- Music: Embedded Mixcloud players with DJ sets
- Calendar: Upcoming events and performance dates
- Gear: Equipment available for booking
- Booking: Contact information and booking process
- Footer: Copyright and social media links
- Modern web browser
- Node.js (for image processing script)
node build-image-manifest.js- Add desktop and mobile versions to numbered folders in
splash-images/ - Run the build script to update
image_data.json - Images will automatically be included in rotation
Edit taglines.json and add new entries to the array.
The site features embedded Mixcloud players showcasing various DJ sets:
- Pride Dance Stage Practice Mix
- Off the Rails Practice Mix
- Jungle & Drum and Bass selections
- Club and Techno selections
- Live performance recordings
There are three easy ways to test the SoundCloud section in index.html (the area with the placeholder "Loading SoundCloud Tracks..."):
This site will first try to load soundcloud_tracks.json. If present, it will render those tracks as embeddable players.
- Ensure a
soundcloud_tracks.jsonexists at the project root. Two supported shapes:- Array [ { "title": "Liquid Dreams", "url": "https://soundcloud.com/dj-nerva/liquid-dreams", "duration": "6:18" } ]
- Object with
tracksarray { "tracks": [ { "title": "Liquid Dreams", "permalink_url": "https://soundcloud.com/dj-nerva/liquid-dreams", "duration": 378000 } ] }
Notes:
urlorpermalink_urlis accepted; it's normalized automatically.durationcan be milliseconds (number) or a string like "mm:ss" or "hh:mm:ss".
Recommended: run a local server so fetch() can read JSON (opening via file:// can block fetch in some browsers).
# From the Website directory
python3 -m http.server 5500
# Then open http://localhost:5500/Verify:
- Open DevTools Console. You should see logs from
soundcloud.jslike:- "Loaded N tracks from JSON (normalized)"
- "Rendered N SoundCloud tracks"
- A list of embedded SoundCloud players should appear under the "Latest Mixes" header.
Tip: After changing soundcloud_tracks.json, in the browser console call:
window.soundcloudIntegration.refresh()to re-render without a full page reload.
Use the provided Node script to fetch tracks from the SoundCloud API and write soundcloud_tracks.json for you.
Setup:
- Copy
.env.exampleto.envand fill in values. - At minimum set:
SOUNDCLOUD_CLIENT_ID=...- Optionally
SOUNDCLOUD_PROFILE_URL=https://soundcloud.com/dj-nerva(defaults to DJ Nerva)
Run the fetcher (Node 18+):
node scripts/soundcloud_fetch.jsIf successful, it writes a normalized document to soundcloud_tracks.json. Refresh your browser page to see the updated embeds.
If your app requires OAuth (or you prefer the v1 endpoints), you can obtain an access token and use that instead of a client_id.
Setup .env:
SOUNDCLOUD_CLIENT_ID=...SOUNDCLOUD_CLIENT_SECRET=...SOUNDCLOUD_REDIRECT_URI=http://localhost:8721/callback(default)
Run OAuth helper:
node scripts/soundcloud_oauth.jsThis will:
- Open a browser for you to authorize the app
- Capture the
codeon a local server - Exchange for
SOUNDCLOUD_ACCESS_TOKEN - Print an export command and also append the token to
.env
Then fetch tracks:
node scripts/soundcloud_fetch.js- If the SoundCloud section doesn't appear, check the console for:
- "SoundCloud tracks container not found" (ensure
#soundcloud-tracksexists inindex.html) - Network errors loading
soundcloud_tracks.json(start a local server and reload) - API errors (401/403): verify
SOUNDCLOUD_CLIENT_IDorSOUNDCLOUD_ACCESS_TOKEN
- "SoundCloud tracks container not found" (ensure
- Caching: hard refresh the page, or add a
?v=timestampto the request when testing. - JSON shape: ensure each item has a
urlorpermalink_url; other fields are optional. - Theme color: the embed color is synced to
--primary-color; youβll see it update on page load.
Common fixes when scripts/soundcloud_oauth.js fails:
- Redirect URI mismatch: The value in
.envforSOUNDCLOUD_REDIRECT_URImust exactly match the Redirect URI configured in your SoundCloud app (including port and path). Default ishttp://localhost:8721/callback. - Missing env vars: Ensure
.envcontainsSOUNDCLOUD_CLIENT_IDandSOUNDCLOUD_CLIENT_SECRETfor the same app. - Node version: Use Node 18+ (script relies on global
fetch). - Port in use: If 8721 is taken, change
SOUNDCLOUD_REDIRECT_URIto another free port and update the app settings accordingly. - Reused/expired code: After authorizing, the
codeparameter can only be used once and expires quickly. Run the script end-to-end without delay. - Network filters: Corporate VPNs or blockers can interrupt the token request. Try on a normal network.
Current upcoming events:
- Baltimore Club Day (July 17, 2025)
- Junglist Basement (July 27, 2025)
Booking Contact: nerva.corporation@gmail.com
- XDJ-RX3 Professional DJ System (included with local bookings)
- Powered Speakers with subwoofer (starting at $250+)
- Complete Open Graph meta tags
- Twitter Card integration
- Structured data for better search visibility
- Instagram social link integration
- Modern browsers (Chrome, Firefox, Safari, Edge)
- Mobile browsers (iOS Safari, Chrome Mobile)
- Progressive enhancement for older browsers
Β© 2025 DJ Nerva. All rights reserved.
This is a client website project. For updates or modifications, contact the developer.
Built with: Vanilla JavaScript, CSS3, HTML5 Location: Baltimore, Maryland Genre: Jungle, Drum & Bass, Techno, House, Baltimore Club
If you just want to update content without running Node scripts:
- Open
index.htmldirectly in your browser. No server needed. - Hero images and colors:
image_data.jsonis used when present. If missing, a fallback image and default colors are applied. - Taglines: Edit
taglines.jsonto adjust the random hero text. - SoundCloud tracks: Edit
soundcloud_tracks.json(added). The website will load from this static file.
soundcloud_tracks.json accepts either of these shapes:
-
Simple array [ { "title": "Liquid Dreams", "url": "https://soundcloud.com/dj-nerva/liquid-dreams", "duration": "6:18" } ]
-
Object with tracks array { "tracks": [ { "title": "Liquid Dreams", "permalink_url": "https://soundcloud.com/dj-nerva/liquid-dreams", "duration": 378000 } ] }
Duration can be a number in milliseconds or a string like "mm:ss" or "hh:mm:ss". URLs are auto-encoded for the embed.
Advanced/optional scripts (only if you need them):
build-image-manifest.jsgeneratesimage_data.jsonwith color palettesscripts/soundcloud_fetch.jsfetches live track data via the SoundCloud API