Skip to content

LoganthP/DevCom-Final-Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Vidyuth 2K25 πŸŽ‰

Vidyuth 2K25

Annual College Fest Website for VidyaVardhaka College of Engineering, Mysuru

Next.js TypeScript Tailwind CSS Firebase AI Powered

πŸ—“οΈ April 25-27, 2025 | πŸ“ VidyaVardhaka College of Engineering, Mysuru

🎯 Overview

Vidyuth 2K25 is the official website for the annual college fest of VidyaVardhaka College of Engineering, Mysuru. This modern, responsive web application features a countdown timer, event timeline, registration system, and interactive UI elements designed to create an engaging experience for students and visitors.


✨ Features

πŸ•’ Live Countdown Timer

  • Real-time countdown to the fest start date (April 25, 2025)
  • Dynamic display of days, hours, minutes, and seconds
  • Auto-refreshing every second

πŸ“… Interactive Event Timeline

  • Chronologically ordered event schedule
  • Date and time information for each event
  • Beautiful card-based layout with hover effects
  • Complete 3-day fest coverage (April 25-27, 2025)

πŸ“ Event Registration System

  • User-friendly registration form
  • Date picker for event selection
  • Form validation and submission handling
  • Contact information collection

🎨 Modern UI/UX Design

  • Vibrant teal accent colors (#008080)
  • Light backgrounds with bright highlights
  • Smooth hover animations and transitions
  • Mobile-responsive design
  • Bold typography for enhanced readability

πŸ“ž Contact Information

  • Dedicated contact section
  • Email and phone information
  • Easy communication channels

πŸŽͺ Event Lineup

Day 1 - April 25, 2025

  • 9:00 AM - Auto Extravaganza
  • 10:00 AM - Mehendi Competition
  • 2:00 PM - Gaming Tournament
  • 7:00 PM - Dance Night

Day 2 - April 26, 2025

  • 9:00 AM - Hackathons and Workshops
  • 10:00 AM - Math Tea Club
  • 11:00 AM - Treasure Hunt
  • 2:00 PM - Dance and Singing Competitions

Day 3 - April 27, 2025

  • 10:00 AM - Art Exhibition
  • 11:00 AM - Dog Show
  • 7:00 PM - Night Concerts
  • 9:00 PM - Music & Dance Party

πŸ› οΈ Tech Stack

Frontend Next.js React TypeScript
Styling Tailwind shadcn/ui Radix UI
Backend & Database Firebase TanStack Query
AI Integration Google AI Genkit
Development Tools Zod React Hook Form date-fns

πŸš€ Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js (18.0 or later)
  • npm or yarn
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/LoganthP/DevCom-Final-Project.git
    cd DevCom-Final-Project
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Set up environment variables

    cp .env.example .env.local

    Configure your environment variables:

    # Firebase Configuration
    NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
    NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
    NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
    
    # AI Configuration (Optional)
    GOOGLE_GENAI_API_KEY=your_google_ai_api_key
  4. Start the development server

    npm run dev
    # or
    yarn dev
  5. Open your browser Navigate to http://localhost:9002 to see the application.


πŸ“ Project Structure

src/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ page.tsx           # Main homepage with all sections
β”‚   β”œβ”€β”€ layout.tsx         # Root layout component
β”‚   └── globals.css        # Global styles
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ ui/                # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ card.tsx
β”‚   β”‚   β”œβ”€β”€ button.tsx
β”‚   β”‚   β”œβ”€β”€ input.tsx
β”‚   β”‚   β”œβ”€β”€ calendar.tsx
β”‚   β”‚   └── ...
β”‚   └── layout/           # Layout components
β”œβ”€β”€ ai/                   # AI integration (optional)
β”œβ”€β”€ lib/
β”‚   └── utils.ts          # Utility functions
└── docs/
    └── blueprint.md      # Project specifications

🎨 Design System

Color Palette

  • Primary: Vibrant Teal (#008080) - Innovation and energy
  • Background: Light backgrounds with bright accents
  • Text: Bold typography for enhanced readability
  • Interactive: Smooth hover effects and transitions

Typography

  • Font: Inter - Clean, modern sans-serif
  • Headings: Bold weights for impact
  • Body: Optimized for readability

Components

  • Cards: Clean, organized layout with hover effects
  • Forms: User-friendly with validation
  • Timeline: Chronological event display
  • Countdown: Real-time timer with dynamic updates

πŸ“Š Development Scripts

# Development
npm run dev              # Start development server with Turbopack (port 9002)
npm run genkit:dev       # Start AI development environment (optional)
npm run genkit:watch     # Watch mode for AI flows (optional)

# Production
npm run build            # Build for production
npm run start            # Start production server

# Quality Assurance
npm run lint             # Run ESLint
npm run typecheck        # TypeScript type checking

πŸ”§ Configuration

Next.js Configuration

  • Turbopack: Enabled for faster development builds
  • TypeScript: Strict mode with build error handling
  • Port: 9002 (customizable)

Tailwind CSS

  • Custom Theme: Festival-themed color palette
  • Component Library: shadcn/ui integration
  • Responsive Design: Mobile-first approach
  • Animations: Smooth transitions and hover effects

🌐 Deployment

Vercel (Recommended)

  1. Push to GitHub
  2. Connect repository to Vercel
  3. Configure environment variables
  4. Deploy automatically

Netlify

  1. Build the project: npm run build
  2. Deploy the out folder to Netlify

Manual Deployment

  1. Build the application: npm run build
  2. Upload build files to your hosting provider
  3. Configure environment variables on the server

🎯 Key Features Deep Dive

Countdown Timer

  • Real-time Updates: Automatically refreshes every second
  • Responsive Design: Adapts to different screen sizes
  • Dynamic Calculation: Calculates time difference to April 25, 2025
  • Visual Appeal: Eye-catching display with proper formatting

Event Timeline

  • Chronological Order: Events sorted by date and time
  • Interactive Cards: Hover effects for better UX
  • Detailed Information: Event name, time, and description
  • Responsive Grid: Adapts to mobile and desktop layouts

Registration System

  • Form Validation: Built-in validation with error handling
  • Date Selection: Interactive calendar for event dates
  • User Experience: Smooth form interactions
  • Data Collection: Name, email, and event preferences

🚦 Performance

  • Fast Loading: Optimized with Next.js and Turbopack
  • Responsive Images: Automatic image optimization
  • Efficient Bundling: Tree shaking and code splitting
  • SEO Optimized: Meta tags and structured data

πŸ”’ Security

  • Environment Variables: Secure configuration management
  • Form Validation: Input sanitization and validation
  • Firebase Integration: Secure backend services
  • Type Safety: TypeScript for compile-time error checking

Code Standards

  • ESLint: Follow the configured rules
  • TypeScript: Strict type checking
  • Prettier: Code formatting
  • Conventional Commits: Clear commit messages

About

It is a TypeScript-based web application developed as a comprehensive final project, showcasing modern frontend development, interactive UI design, and practical implementation of full-stack or component-driven features.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages