Skip to content

priyacha123/GFGxELIXIR

 
 

Repository files navigation

GfG × Elixir Hackathon

A hackathon website built with Next.js 16, featuring immersive animations, real-time and comprehensive event information for an unforgettable developer experience.

Features

  • Responsive Design: Mobile-first approach with adaptive layouts
  • Interactive Animations: GSAP-powered scroll animations and smooth transitions
  • Real-time Countdown: Live countdown timer to hackathon commencement
  • Modern UI: Dark theme with gradient accents and glassmorphism effects
  • Performance Optimized: Lightning-fast load times with Next.js optimizations
  • Component Architecture: Modular React components with reusable UI elements
  • Multi-section Layout: Hero, About, Tracks, Timeline, Sponsors, Prizes, FAQ, Contact

Tech Stack

Frontend

  • Next.js 16 - React framework with App Router
  • React 19 - UI library with modern hooks
  • JavaScript - ES6+ with modern syntax

Styling & UI

  • Tailwind CSS 4 - Utility-first CSS framework
  • shadcn/ui - Component library built on Radix UI
  • GSAP - Animation library for advanced interactions
  • Framer Motion - Additional animation capabilities

Development Tools

  • ESLint - Code linting with Next.js configuration
  • PostCSS - CSS processing with Tailwind plugin
  • Bun - Ultra-fast package manager

Fonts & Icons

  • Geist Sans & Mono - Modern font family from Vercel
  • Lucide React - Comprehensive icon library
  • Google Fonts - Audiowide, Bebas Neue, DM Sans

Getting Started

Prerequisites

  • Node.js 18+ (required for Next.js 16)
  • Bun package manager (recommended - detected via bun.lock file)
  • Git for version control

Installation

# Clone the repository
git clone <repository-url>

# Navigate to the project directory
cd gfg-x-elixir

# Install dependencies using Bun (recommended)
bun install

# Alternatively, use npm if Bun is not available
npm install

Environment Setup

This project is designed as a static marketing site and does not require environment variables for basic functionality. All configuration is handled through the application code and build process.

Run Locally

# Using Bun (recommended)
bun run dev

# Using npm
npm run dev

Open http://localhost:3000 to view the application.

Usage

Development

bun run dev      # Start development server with hot reload
bun run lint     # Run ESLint for code quality checks

Production

bun run build    # Create optimized production build
bun run start    # Start production server

Note: Contribution guidelines are not explicitly defined in the repository. Feel free to submit issues and pull requests following standard open-source practices.

Support & Maintenance

This project is maintained as part of the GfG × Elixir Hackathon 2025 initiative.

Getting Help

  • GitHub Issues: Check the repository's Issues tab for bug reports and feature requests
  • Code Review: Review the codebase structure for understanding component architecture
  • Documentation: Refer to Next.js documentation for framework-specific questions

Maintenance

The project follows modern web development practices with regular updates to dependencies and frameworks. Key areas include:

  • Security updates and dependency patches
  • Performance optimization and user experience improvements
  • Feature enhancements based on hackathon requirements

Disclaimer: Specific support contact information is not explicitly defined in the repository. Please use GitHub Issues for formal support requests.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 95.8%
  • CSS 4.2%