MonarchIntel: TitanDex & Research Terminal

MonarchIntel is a high-fidelity intelligence database and tactical research terminal dedicated to monitoring and analyzing Titan-class organisms (Kaiju) across the Godzilla/Kong MonsterVerse and historic eras. Built on a terminal-HUD theme, it provides a centralized interface for Monarch analysts to track threat activity, examine media files, simulate Titan combat, and draft field reports.

---

Core Features & Capabilities

graph TD
    A[MonarchIntel Hub] --> B[TitanDex Database]
    A --> C[Watch Order & Media Files]
    A --> D[Subterranean Combat Simulator]
    A --> E[Classified Dossier Generator]
    A --> F[Interactive Mapping & Visualizer]

    B --> B1[Threat Classification]
    C --> C2[TMDB Cached Content]
    D --> D1[Turn-Based Battle Logs]
    E --> E1[Anthropic Claude AI integration]
    F --> F1[Visual Scale Charts]
    F --> F2[Titan Relationship Networks]
    F --> F3[Cross-Linked Timeline]

Loading

📂 TitanDex Database

An interactive, filterable catalog of all documented Titan-class organisms.

• Detailed Metrics: Analyzes height, weight, status, location, primary abilities, and threat levels (ranging from Minor to Omega).
• Era Classifications: Easily switch between specific eras: Shōwa, Heisei, Millennium, Reiwa, MonsterVerse, and Animation.

🎬 Watch Order & Episode Logs

A complete archive of films and TV series.

• Real-time Enrichment: Integrates directly with the TMDB API to dynamically fetch movie posters, backdrops, user scores, and air dates.
• Build-time Caching: Implements a robust JSON-payload caching mechanism under .cache/tmdb/ to prevent network delays and API rate limits, reducing static compilation time to under 3 seconds.
• Episodes breakdown: Granular detail cards for television seasons (such as Monarch: Legacy of Monsters and Godzilla Singular Point) containing specific synopsis files and featured Titans.
• Tracker: Client-side interactive checkbox to mark entries as "Watched" (stored in LocalStorage).

⚔️ Subterranean Combat Simulator

A tactical simulator designed to model encounter results between Titan classes.

• Environmental Adjustments: Choose from various battle arenas (e.g. Hollow Earth, Tokyo, San Francisco, Antarctica) that apply distinct environment buffs or debuffs.
• Turn-Based Simulation: Tracks attack accuracy, dodge chance, critical hits, health bars, and outputs detailed real-time telemetry combat logs.

📝 Classified Dossier Generator

A secure interface for research analysts to compile intelligence reports.

• Security-First Architecture: Features a local API key rotation system. The Anthropic API key is supplied by the user, stored securely in the client's browser localStorage, and never exposed on the network.
• Generative Reports: Uses Claude to craft structured dossiers describing a selected Titan's bio, behavior, threat level, combat recommendations, and tactical notes.

📊 Interactive Mapping & Visualizers

• Size Chart: A scale visualizer aligning multiple Titans alongside comparison markers (such as a human reference).
• Relations Graph: An interactive network node layout charting alliances, rivalries, and symbiotic ties between major Titans.
• Cross-Linked Timeline: A historical log detailing milestones from 251M BC to the projected future. Timeline milestones are cross-linked to their source media (e.g. Kong: Skull Island (2017) or Monarch Season 2 Episode 1), allowing instant navigation and modal display on click.

---

Technical Specifications

Tech Stack

• Framework: Astro (v4.0+)
• Language: TypeScript (Strict compilation rules enabled)
• Styling: Vanilla CSS3 (Terminal HUD aesthetic, glassmorphic panels, glowing text highlights, and customized animations)
• Build Optimization: File-system request caching for API endpoints
• Formatting/Linting: Prettier & ESLint

Directory Structure

TitanDex/
├── .cache/                    # TMDB build-time cache
├── src/
│   ├── components/            # Astro components (SEO, etc.)
│   ├── data/                  # Source intelligence data (JSON)
│   │   ├── episodes.json      # TV Series episode data
│   │   ├── movies.json        # Movie catalog & TMDB IDs
│   │   ├── timeline.json      # Historical events with cross-links
│   │   └── titans.json        # Detailed Titan profiles
│   └── pages/
│       ├── index.astro        # Main Dashboard / Application HUB
│       └── dossier.astro      # Dossier generation sub-terminal
├── tsconfig.json              # Strict type configuration
└── astro.config.mjs           # Astro setup

---

🚀 Setup & Installation

Prerequisites

• Node.js (v18.0+)
• npm (v9.0+)

1. Clone & Install

git clone https://github.com/Prathamesh913/monarchintel.git
cd monarchintel
npm install

2. Configure Environment Keys

Create a .env file in the root directory and supply a TMDB API read access token (required to fetch movie posters and details during build):

TMDB_API_KEY=your_tmdb_read_access_token_here

(Note: To generate analyst reports inside the Dossier Generator tab, you will input your Anthropic API Key directly into the secure browser interface).

3. Run Development Server

npm run dev

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

4. Build for Production

To compile a optimized static build:

npm run build
npm run preview

---

🎨 Design & Aesthetics

MonarchIntel is designed to look like an authentic military monitor or classified intelligence terminal:

• Colors: Deep charcoal backgrounds paired with high-contrast indicator glows (Monarch Amber, Threat Crimson, Nuclear Green, and Subterranean Blue).
• Typography: Clean sans-serif headings combined with monospaced terminal grids and typewriter-style serif text for synopses and dossiers.
• Performance: Zero heavy JS framework runtimes; interactive views are driven by optimized vanilla JS and CSS micro-animations.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.