Skip to content

kartikey2004-git/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