RetroHub

The premium retro gaming experience. Play classic games from NES, SNES, Game Boy, Genesis and more — directly in your browser.

Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS + shadcn/ui
• Emulation: EmulatorJS (RetroArch WASM cores)
• Hosting: Vercel-ready

Getting Started

Prerequisites

• Node.js 18+
• npm or pnpm

Installation

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 to see the app.

Project Structure

retrohub/
├── app/                        # Next.js App Router pages
│   ├── page.tsx               # Landing page
│   ├── retroplay/             # Emulation section
│   │   ├── page.tsx          # Console selector
│   │   └── [console]/
│   │       ├── page.tsx       # Game grid
│   │       └── [game]/play/   # Emulator player
├── components/
│   ├── ui/                   # shadcn/ui components
│   └── retroplay/            # RetroPlay components
│       ├── ConsoleSelector   # Console selection grid
│       ├── GameCard          # Individual game card
│       ├── GameGrid          # Game grid with filters
│       └── EmulatorPlayer    # Emulator wrapper
├── data/
│   └── mock-data.ts          # Mock console/game data
└── lib/
    └── utils.ts              # Utility functions

Features

• Console selector with visual cards
• Game grid with search and genre filter
• EmulatorJS integration (NES, SNES, GB, GBC, GBA, Genesis, PS1)
• CRT filter effect
• Fullscreen mode
• Load ROM from local file
• Responsive design

Coming Soon

• User authentication (NextAuth)
• Save states (cloud sync)
• Premium subscriptions
• RetroShop (bundles)
• Minijuegos IA (AI game creator)
• Netplay (multiplayer)

EmulatorJS Setup

The project uses EmulatorJS to embed RetroArch WASM cores directly in the browser. This provides:

• 100+ emulated systems
• No native installation required
• Cross-platform compatibility
• Built-in save states

ROMs

Important: This project does not include any ROM files. To play games:

1. Your own ROMs: Use the "Load ROM" button in the emulator to load your own legally-owned game files
2. Public domain games: Several classic games are in the public domain and freely available
3. Homebrew: New games created by the community are freely available

Always ensure you have the legal right to play any game ROM you use.

License

MIT License - See LICENSE file for details.