Skip to content

Ayush07571/Neon-Arena

Repository files navigation

๐ŸŽฎ Neon Arena - Cyberpunk Gaming Hub

๐ŸŒŸ Overview

Neon Arena is a cutting-edge cyberpunk-themed gaming hub landing page that delivers an immersive first impression with advanced 3D graphics, interactive animations, and stunning visual effects. Built with modern web technologies to create a premium gaming experience.

๐ŸŽฏ Key Features

  • ๐ŸŽจ Cyberpunk Design: Immersive neon aesthetic with glassmorphism effects
  • ๐Ÿค– 3D Bot Element: Interactive 3D character with real-time animations
  • โœจ Particle System: Dynamic particles responding to mouse movement
  • ๐ŸŽญ Canvas Graphics: Custom WebGL-powered visual effects
  • ๐Ÿ“œ Scroll Animations: Smooth parallax and object animations
  • ๐ŸŽฎ 3D Tilt Effects: GPU-accelerated interactive elements
  • ๐Ÿ“ฑ Responsive Design: Adaptive layout for all screen sizes
  • โ™ฟ WCAG 2.1 AA: Fully accessible with proper ARIA labels
  • โšก 60fps Performance: Optimized animations with adaptive quality

๐Ÿš€ Tech Stack

Frontend

  • Framework: Next.js 16.1.6 with App Router
  • UI Library: React 19.2.3 with TypeScript
  • Styling: TailwindCSS 4.0 with custom neon theme
  • Animations: Framer Motion for 60fps animations
  • 3D Graphics: Three.js & React Three Fiber
  • Smooth Scrolling: Lenis for buttery-smooth navigation

Development Tools

  • Language: TypeScript 5.0 with strict mode
  • Package Manager: npm with modern dependencies
  • Code Quality: ESLint & Prettier configuration
  • Testing: Vitest + Playwright for comprehensive coverage

๐Ÿ—๏ธ Project Structure

neon-arena/
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ ui/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ buttons/          # Neon button components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ cards/           # Glassmorphism cards
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ navigation/      # Tubelight navigation
โ”‚   โ”‚   โ”œโ”€โ”€ layout/              # Header, Footer, MainLayout
โ”‚   โ”‚   โ””โ”€โ”€ features/hero/     # Hero section components
โ”‚   โ”œโ”€โ”€ sections/                # Page sections (hero, features, etc.)
โ”‚   โ”œโ”€โ”€ hooks/                  # Custom React hooks
โ”‚   โ”œโ”€โ”€ lib/                    # Utility functions
โ”‚   โ””โ”€โ”€ styles/                 # Global styles and CSS variables
โ”œโ”€โ”€ public/                     # Static assets
โ”œโ”€โ”€ tests/                      # Component and E2E tests
โ””โ”€โ”€ docs/                       # Documentation

๐ŸŽฎ Interactive Features

3D Bot Element

  • Real-time Animation: Smooth character movements
  • Mouse Interaction: Bot responds to cursor position
  • Performance Optimized: GPU-accelerated rendering

Particle System

  • Dynamic Particles: 50+ animated particles
  • Mouse Tracking: Particles follow cursor movement
  • Collision Detection: Interactive particle behaviors

Canvas Graphics

  • WebGL Rendering: Hardware-accelerated graphics
  • Real-time Updates: Smooth 60fps animations
  • Custom Shaders: Advanced visual effects

Scroll Animations

  • Parallax Effects: Multi-layer depth perception
  • Object Animations: Scroll-triggered element movements
  • Smooth Transitions: Seamless section navigation

๐ŸŽจ Design System

Cyberpunk Theme

/* Neon Color Palette */
--neon-cyan: #00ffff;
--neon-magenta: #ff00ff;
--neon-yellow: #ffff00;
--neon-green: #00ff00;
--neon-blue: #0088ff;

/* Glassmorphism Effects */
--glass-bg: rgba(255, 255, 255, 0.1);
--glass-border: rgba(255, 255, 255, 0.2);
--glass-blur: 12px;

Component Library

  • NeonButton: Glowing buttons with hover effects
  • GlassmorphismCard: Blur effects with neon borders
  • NeonNavigation: Tubelight-style navigation bar
  • 3D Elements: Interactive components with tilt effects

๐Ÿ“ฑ Responsive Design

Breakpoints

  • Mobile: < 768px (simplified animations)
  • Tablet: 768px - 1024px (medium complexity)
  • Desktop: > 1024px (full feature set)

Performance Optimization

  • Adaptive Quality: Device capability detection
  • Lazy Loading: Images and 3D assets
  • Memory Management: Efficient particle systems
  • 60fps Target: Optimized animation loops

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+ and npm
  • Modern web browser with WebGL support

Installation

# Clone the repository
git clone https://github.com/yourusername/neon-arena.git

# Navigate to project directory
cd neon-arena

# Install dependencies
npm install

# Start development server
npm run dev

Environment Variables

# Create .env.local file
NEXT_PUBLIC_SITE_URL=http://localhost:3000
NEXT_PUBLIC_API_URL=http://localhost:3000/api

๐Ÿงช Testing

Unit Tests

# Run component tests
npm run test

# Run tests with coverage
npm run test:coverage

E2E Tests

# Run end-to-end tests
npm run test:e2e

# Run tests in headed mode
npm run test:e2e:headed

๐Ÿ“Š Performance Metrics

Core Web Vitals

  • LCP: < 2.5s (Good)
  • FID: < 100ms (Good)
  • CLS: < 0.1 (Good)

Animation Performance

  • Target FPS: 60fps
  • Particle Count: 50 (adaptive)
  • Memory Usage: < 50MB
  • GPU Acceleration: Enabled

๐ŸŽฏ Browser Support

Modern Browsers

  • โœ… Chrome 90+
  • โœ… Firefox 88+
  • โœ… Safari 14+
  • โœ… Edge 90+

Required Features

  • WebGL 2.0 support
  • ES6+ JavaScript
  • CSS Grid & Flexbox
  • RequestAnimationFrame API

๐Ÿค Contributing

Development Workflow

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Run tests (npm run test)
  5. Commit changes (git commit -m 'Add amazing feature')
  6. Push to branch (git push origin feature/amazing-feature)
  7. Open Pull Request

Code Style

  • Use TypeScript strict mode
  • Follow ESLint configuration
  • Write meaningful commit messages
  • Add tests for new features

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • Three.js for 3D graphics capabilities
  • Framer Motion for smooth animations
  • TailwindCSS for utility-first styling
  • Lenis for buttery-smooth scrolling

๐ŸŽฎ Built with passion for the gaming community ๐ŸŽฎ

About

๐ŸŽฎ Neon Arena - Cyberpunk gaming hub with 3D graphics, particle systems, and immersive animations โœจ Built with Next.js 16.1.6, React 19.2.3, TypeScript, and TailwindCSS 4.0

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors