Skip to content

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

Packages

Contributors

Languages