Skip to content

AdityaDhanarajKundu/Impulse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

48 Commits
Β 
Β 
Β 
Β 

Repository files navigation

🌟 Impulse 2K25 – Fest Website

A fully responsive, modern, and dynamic website for Midnapore Medical College's annual fest Impulse 2K25, built using:

  • βš›οΈ React + Vite
  • πŸ’¨ Tailwind CSS v4
  • πŸŽ₯ 3D & video background elements
  • 🎬 Animated transitions with Framer Motion
  • πŸŒ™ Dark/light theme support
  • 🧭 React Router SPA routing
  • ☁️ Deployed on Vercel

πŸ“ Project Structure

β”œβ”€β”€ public/ # Public assets β”œβ”€β”€ src/ β”‚ β”œβ”€β”€ assets/ # All images/videos/logos β”‚ β”œβ”€β”€ components/ # Reusable components (Navbar, Footer, Loader, etc.) β”‚ β”œβ”€β”€ data/ # Static JSON data (sponsor logos, members) β”‚ β”œβ”€β”€ pages/ # Main page components (Home, Events, Schedule, etc.) β”‚ β”œβ”€β”€ App.jsx # Root component with Router β”‚ └── main.jsx # React entry point β”œβ”€β”€ tailwind.config.js # Tailwind v4 setup β”œβ”€β”€ index.html # Root HTML └── vercel.json # SPA rewrite for Vercel routing


πŸš€ Live Demo

πŸ”— Visit Live Website


πŸ§ͺ Features

  • βœ… Fully responsive layout
  • βœ… Framer Motion phrase animation
  • βœ… Dynamic routing using react-router-dom
  • βœ… Background video sections for immersive design
  • βœ… Sponsor grid with 3D hover animation
  • βœ… Teaser & gallery with video and carousel
  • βœ… Modern, accessible UI with Tailwind
  • βœ… Deployment-ready for Vercel (with SPA routing support)

πŸ› οΈ Installation & Development

1. Clone the repository

git clone https://github.com/your-username/impulse-2k25.git
cd impulse-2k25

2. Install dependencies

npm install 

3. Run the development server

npm run dev

App will be served at http://localhost:5173


βš™οΈ Vercel Deployment Instructions

βœ… React SPA Routing Fix (Important)

Create a vercel.json file in the root:

{
  "rewrites": [
    { "source": "/(.*)", "destination": "/" }
  ]
}

This ensures all React routes work even on direct URL entry like /events, /gallery, etc.

✨ Pages Overview

Page Path Description
Home / Hero section with video bg, animated CTA
Events /events Day-wise fest event cards
Schedule /schedule Timetable of the full fest
Sponsors /sponsors Sponsor logos grid with CTA
Gallery /gallery Teasers, photos, reels, carousel
Members /members Member cards by designation
About /about About MMCH & Impulse Fest

πŸ“¦ External Dependencies


πŸ’‘ Tips

  • 🧠 Use Link from react-router-dom instead of <a> tags for internal routing:

    import { Link } from "react-router-dom";
    
    <Link to="/events">Explore Events</Link>
  • πŸ›‘ Avoid href="/events" directly β€” it causes full-page reloads and breaks SPA routing.

  • πŸ“Ή Use CDN-hosted videos (e.g., Cloudinary) with preload="auto" to reduce lag and improve performance.


✍️ Contributing

  1. Fork the repository

  2. Create a new branch for your feature or fix:

    git checkout -b feature/your-feature
  3. Commit your changes:

    git commit -m "✨ Add new feature"
  4. Push to your fork:

    git push origin feature/your-feature
  5. Submit a Pull Request βœ…

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published