An interactive 3D archive for exploring the Marvel Cinematic Universe in chronological order.

---

🌟 About the Project

MCU Chronoverse is a cinematic, interactive guide to the Marvel Cinematic Universe. Explore the timeline from beginning to end, filter entries by format, compare chronological and release order, and keep track of what you have watched.

The archive includes films, series, specials, shorts, one-shots, and upcoming entries, with enriched metadata and links to IMDb.

✨ Features

🌌 Interactive 3D Timeline Navigate a glowing, slightly organic timeline with smooth scrolling, dragging, and pinch zoom.	🎛️ Flexible Filters Filter the archive by films, series, specials, shorts, one-shots, phases, and timeline order.
✅ Watch Progress Mark released entries as watched and see what is next in the current filtered view.	🔐 Optional Accounts Use the site anonymously or sign in with Supabase to keep watch progress available across devices.
🎞️ Rich Metadata View posters, descriptions, ratings, genres, release information, IMDb links, and credit-scene details.	📝 Community Corrections Suggest timeline corrections, missing entries, and website improvements through GitHub issues.

🚀 Requirements

• Bun

🛠️ Setup

1. Clone the repository:

   git clone https://github.com/Valhalla-Development/MCUChronoverse.git
   cd MCUChronoverse

2. Install dependencies:

   bun install

3. Copy .env.example to .env and add any values needed for the functionality you want to run locally. The example documents the available authentication, contact submission, Turnstile, and metadata enrichment settings.

4. Start the development server:

   bun run dev

   Open http://localhost:3000 in your browser.

🧪 Development commands

bun run dev          # Start the local development server
bun run lint         # Run TypeScript and Biome checks
bun run type-check   # Run the TypeScript checker
bun run data:enrich  # Refresh cached metadata with TMDB and Trakt

The metadata enrichment script requires TMDB and Trakt API credentials documented in .env.example. It is intended for development use and should not be run as part of the production application.

🤝 Contributing

Contributions and corrections are welcome.

1. Fork the repository.
2. Create a focused branch for your change.
3. Run bun run lint before opening a pull request.
4. Open a pull request using the repository template.

For timeline corrections, missing entries, and suggestions, use the issue templates.

📜 License

This project is licensed under the GPL-3.0 License. See LICENSE for details.

---

💻 Crafted with ❤️ by Valhalla-Development

🐛 Report a timeline issue | 💡 Suggest an improvement

🔝 Back to Top