Skip to content

drishyam27/GOT

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

⚔️ Game of Thrones: The Chronicles of Westeros

An immersive, cinematic, and interactive web experience designed to transport fans into the world of Game of Thrones. This application integrates cutting-edge web technologies, high-fidelity dark-fantasy aesthetics, and advanced scroll-linked animations to bring the stories of Westeros and its Great Houses to life.


🌌 Live Demo & Host

The application runs locally on http://localhost:5173/.


📽️ Key Cinematic Features

1. Scroll-Triggered Chaptered Journey (Hero Component)

  • Video scrubbing: A high-definition ambient cinematic background video is bound directly to the user's scrollbar. As you scroll, the playback scrubs smoothly backward and forward through key Westeros landmarks.
  • Narrative Chapters: Features six scroll-activated chapters, transitioning beautifully from the Prologue to the Iron Throne:
    1. The Ancient Chronicles (A Song of Ice and Fire) — 01 / 06
    2. The North Remembers (House Stark) — 02 / 06
    3. The Seven Kingdoms (The Realm of Westeros) — 03 / 06
    4. Where Crowns Are Won (King's Landing) — 04 / 06
    5. A Thousand Blades (The Iron Throne Origin) — 05 / 06
    6. The Iron Throne (When You Play the Game of Thrones) — 06 / 06
  • Dynamic GSAP Animations: Custom timeline animations orchestrate staggered text transitions, sigil fades, and vignette adjustments when transitioning between chapters.
  • Visual Indicators: Features a custom-rendered vertical Dot Navigator, an active chapter label tracking progress, and a bottom-aligned progress bar.

2. Interactive House Gallery (Section1 Component)

  • Glassmorphic Design: Sleek card designs incorporating thematic color-tailored gradients, custom gold and iron corner ornaments, and micro-animations.
  • Interactive 3D Sigil Tilt: Utilizing real-time mouse coordinate tracking, the house sigils dynamically tilt and scale as the cursor floats over cards, giving a physical depth to the interface.
  • IntersectionObserver Transitions: Elements trigger staggered, fade-up entrance animations dynamically as they scroll into view.
  • Six Noble Houses:
    • 🐺 Stark"Winter Is Coming" (The North)
    • 🦁 Lannister"Hear Me Roar" (The Westerlands)
    • 🐉 Targaryen"Fire and Blood" (The Crownlands)
    • 🦌 Baratheon"Ours Is The Fury" (The Stormlands)
    • 🦑 Greyjoy"We Do Not Sow" (The Iron Islands)
    • 🌹 Tyrell"Growing Strong" (The Reach)
  • Hover Reveal Mechanic: Cards expand upon hover, dynamically shifting to reveal the House Words, specialized background accents, and an in-depth historic lore description.

🛠️ Architecture & Tech Stack

The application is structured as a component-driven React project built on top of the ultra-fast Vite bundler.

  • Frontend Library: React 19 — Declarative component structure and state management (useState, useRef, useEffect).
  • Build Tool: Vite 8 — Lightning-fast development server with hot module replacement (HMR) and optimized build times.
  • Animation Engine: GSAP (GreenSock Animation Platform) 3.15 & ScrollTrigger Plugin — High-performance scroll-driven timelines, interactive video scrubbing, elastic animations, and staggered triggers.
  • Styling: Vanilla CSS — Maximum styling flexibility using CSS custom properties (variables), tailored HSL themes, fluid layouts (Flexbox, Grid), 3D perspective transformations, and ambient grain overlays.

📂 Codebase & Folder Walkthrough

GOT-main/
├── README.md                # Project documentation (this file)
├── .gitattributes           # Git configurations
└── vite-project/            # Main React + Vite project directory
    ├── index.html           # HTML Entry point
    ├── package.json         # NPM scripts and project dependencies
    ├── vite.config.js       # Vite build configurations
    ├── public/              # Static assets
    │   ├── images/          # House sigil images
    │   └── video/           # Background cinematic scrubbing video
    └── src/
        ├── App.jsx          # Root component hosting Hero and Section1
        ├── App.css          # Global and canvas styles
        ├── index.css        # Typography and main layout variables
        ├── main.jsx         # React application entry point
        └── components/
            ├── Hero.jsx     # Cinematic scroll-bound video chapter experience
            ├── Hero.css     # Dark ambient styles, ornaments, and scroll tracking
            ├── Section1.jsx # Staggered grid showing House Cards with 3D tilts
            └── Section1.css # Interactive card grids and layout styling

🚀 Setup & Local Development

Prerequisites

Make sure you have Node.js installed (v18+ recommended).

Steps

  1. Clone the Repository:
    git clone https://github.com/drishyam27/GOT.git
    cd GOT
  2. Navigate to the project and install dependencies:
    cd vite-project
    npm install
  3. Run the local development server:
    npm run dev
  4. Open in your browser: Navigate to http://localhost:5173/ to enjoy the experience!

Building for Production

To bundle and optimize the application for deployment:

npm run build

This generates a production-ready dist folder inside vite-project containing optimized assets.


🔄 Development Workflow

To add features, debug, or customize this interactive experience, follow this structured workflow:

1. Feature / Content Configuration

  • Narrative Chapters: To edit, add, or remove chapters in the scroll scrubbing sequence, modify the CHAPTERS array in Hero.jsx. You can adjust scroll boundaries (progress: [start, end]), titles, description text, and emoji sigils.
  • Noble Houses: To update houses, sigils, regional accents, or historical details, modify the HOUSES configuration array in Section1.jsx.

2. Animation & Motion Design

  • Scroll-Trigger Settings: Adjust scrollHeight or the ScrollTrigger scrub latency (currently set to 1.2 for smooth elastic feedback) in the useEffect within Hero.jsx.
  • 3D Card Tilt: Customize the tilt angles and sensitivity in HouseCard inside Section1.jsx by altering the multiplier in handleMouseMove (currently 14deg).

3. Styling & Theming

  • Global Styling: Modify variables like font family (Outfit and Cinzel), base grain backgrounds, and typography in index.css.
  • Component Styling: Adjust glassmorphic styling, HSL tail-colors, pulse rates, and layouts in Hero.css and Section1.css.

4. Verification & Testing

  • Verify that the scroll-triggered video scrubs smoothly without lag.
  • Verify that hover cards function as expected on all viewport sizes (desktop and mobile responsiveness).
  • Ensure that the IntersectionObserver staggers trigger beautifully as elements enter the viewport.

5. Git Contribution Cycle

# 1. Stage your modifications
git add .

# 2. Commit with descriptive messages
git commit -m "feat: customize House Stark description and adjust tilt sensitivity"

# 3. Push to your GitHub fork repo
git push origin main

🏛️ Credits & Acknowledgements

  • Video and image content are inspired by HBO's Game of Thrones and George R. R. Martin's A Song of Ice and Fire.
  • Animations crafted with GSAP.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • CSS 49.9%
  • JavaScript 49.3%
  • HTML 0.8%