Repository navigation
Architecture and Tech Stack
The Marvel Multiverse Roadmap is engineered using pure Vanilla Web technologies with zero heavy dependencies, achieving sub-second load times, 100% SEO indexability, and clean mobile performance.
┌────────────────────────────────────────────────────────┐
│ Client Browser │
│ ┌───────────────┐ ┌────────────────┐ ┌───────────┐ │
│ │ Semantic HTML │ │ Glassmorph CSS │ │ App State │ │
│ │ (Pre-rendered)│ │ (Custom Props) │ │ (app.js) │ │
│ └───────────────┘ └────────────────┘ └─────┬─────┘ │
│ │ │
│ ┌────────────────────────────────────┼──────┐ │
│ ▼ ▼ │ │
│ LocalStorage DOM Updates │ │
│ - Watched IDs - Sticky HUD │ │
│ - Skipped IDs - Filters │ │
│ - Star Ratings - Modal │ │
└───────────────────────────────────────────────┼────────┘
│ fetch()
▼
┌───────────────────────┐
│ Vercel Serverless API │
│ /api/presence │
└───────────────────────┘
Instead of heavyweight frontend frameworks (React, Next.js, Vue) that ship megabytes of JavaScript runtime overhead, this application uses:
-
HTML5: Fully semantic structure (
<header>,<main>,<article>,<details>,<ol>). - Vanilla JavaScript (ES6+): Custom DOM rendering, event delegation, and micro-animations with 0 external npm dependencies.
- Modern CSS3: Handcrafted dark glassmorphism utilizing CSS custom properties, backdrop blur filters, and CSS grid/flexbox.
To ensure search engines (Googlebot, Bing) and non-JavaScript clients can immediately parse all 121 title cards:
-
Build Step:
npm run prerenderexecutesnode scripts/prerender.js. -
Output:
- Injects all 121 fully formed
<li class="timeline-item">elements directly intoindex.html. - Computes initial HUD values (
LEFT,PACE) for instant first-paint display before client-side hydration. - Injects 121-item Schema.org
ItemList,WebApplication, andFAQPageJSON-LD structured data.
- Injects all 121 fully formed
The interface adapts seamlessly across all display form factors without layout distortion or horizontal overflow:
- Desktop (> 1024px): Dual alternating timeline with central 600px gradient rail, 520px cards, and spacious ambient hero canvas.
-
Tablets (681px - 1024px): Single rail layout with cards constrained to
max-width: 580pxto maintain cinematic aspect ratio. -
Mobile (≤ 680px): Header actions switch to symmetric touch-friendly rows, cards convert to vertical column banners with top-rounded media (
border-radius: var(--radius-lg) var(--radius-lg) 0 0), and floating buttons integrate iOS safe-area insets (env(safe-area-inset-bottom)). -
Compact Mobile (≤ 480px): Timeline rail shifts inward to
20pxand node to28px, saving20px+of width; all three action buttons (Mark watched, Skip, Trailer) lock to equal widths and a uniform33pxheight. -
Ultra-Small Displays (≤ 360px): Timeline rail compacts to
15px, and card action buttons wrap gracefully (full-width Mark watched top row, side-by-side Skip and Trailer bottom row).
The application maintains a strict z-index stacking model to prevent card overlap while scrolling past sticky navigation:
| Layer | CSS Class / Selector | z-index |
Purpose |
|---|---|---|---|
| Toast Notifications | .toast-container |
1100 |
Always on top of all modals and menus |
| Trailer Modal Overlay | .modal-overlay |
1000 |
Fullscreen backdrop dialog |
| Online Presence Badge | .online-presence |
100 |
Fixed top-right live visitor indicator |
| Floating Navigation | .floating-fab |
95 |
Bottom-left & bottom-right jump FABs |
| Sticky HUD Rail | .sticky-hud-rail |
90 |
Floats cleanly above all scrolling cards |
| Active Popovers | .has-open-popover |
60 |
Elevates card above adjacent siblings |
| Timeline Nodes | .timeline-node |
10 |
Central numbered milestone circles |
| Central Rail Line | .timeline-central-rail |
1 |
Alternating gradient timeline spine |
| Dynamic Hero Canvas | .hero-bg |
0 |
Crossfading ambient poster background |
The online presence indicator at the top right displays active visitors without requiring continuous WebSockets:
- A lightweight Vercel Serverless Function tracks active sessions via ephemeral memory with expiration timestamps.
- The frontend heartbeats periodically using
fetch('/api/presence', { cache: 'no-store' }). - Graceful fallback defaults to
1 onlineif offline or deployed locally.
Every pull request and push to main executes GitHub Actions (.github/workflows/ci-cd.yml):
-
npm run lint: Verifies syntax across all JS files vianode --check. -
npm test: Executestest/validate-data.js:- Validates sequential dataset integrity (1 to 121).
- Asserts all 242 portrait and landscape WebP images exist on disk.
- Asserts all community documents (
README.md,CONTRIBUTING.md,CONTRIBUTORS.md,CODE_OF_CONDUCT.md,SECURITY.md,CITATION.cff) exist. - Validates SEO metadata, Schema.org graph, and z-index regression rules.