Skip to content
umeshkumar-gitPublic

About

Play 70+ exciting mini games in one place with NovaPlay. Jump straight into the action with no account creation or downloads needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ NOVAPLAY

A High-Performance, Full-Stack Web Gaming Platform

Next.js React TypeScript Node.js MongoDB Tailwind CSS License: MIT CI/CD Status

๐Ÿ”— Live Demo โ€ข ๐Ÿ“‘ Documentation โ€ข โœจ Features โ€ข ๐Ÿš€ Getting Started โ€ข ๐Ÿค Contributing


๐ŸŒ Live Deployment & Preview

Live Application URL: https://novaplay-demo.vercel.app (Replace with your live production URL)
API Status: Operational | Target Deployment: Vercel (Frontend) / Node.js + MongoDB Atlas (Backend)

+-------------------------------------------------------------------------------+
|                                                                               |
|                   [ ๐Ÿ“ธ INSERT HERO / DASHBOARD SCREENSHOT ]                    |
|                                                                               |
|   Recommended: 1280x720 screenshot of the NOVAPLAY catalog and active game     |
|   assets/screenshots/novaplay-hero-banner.png                                  |
|                                                                               |
+-------------------------------------------------------------------------------+

๐Ÿ“‘ Table of Contents


โšก Executive Overview

NOVAPLAY is a modern, responsive full-stack gaming ecosystem engineered to bring classic arcade, puzzle, strategy, board, card, and sports titles into a single, cohesive web platform. Designed with performance, accessibility, and clean architecture as first-class citizens, NOVAPLAY pairs a responsive React/Next.js frontend with low-latency client rendering, customizable audio synthesis, and persistent cloud session tracking via Node.js and MongoDB.

Why This Project Stands Out (Engineering Highlights)

  • Modular Component Design: Decoupled game engine logic with 70+ playable titles isolated into self-contained React functional components.
  • Custom React Hooks: Business logic, game state loops, audio synthesis, and window lifecycle events are cleanly separated into reusable, testable hooks.
  • Full-Stack Data Persistence: User progression, recently played history, game analytics, and theme state are managed through a dual-tier strategy (optimistic client persistence + MongoDB cloud synchronization).
  • Zero-Latency Audio Engine: Built-in Web Audio API synthesizer generates retro sound effects and ambient tracks dynamically without blocking network assets.
  • PWA & Offline Capability: Service worker caching allows offline gameplay across desktop, tablet, and mobile form factors.

๐Ÿ› System Architecture

graph TD
    Client[Client Browser / PWA] -->|Interactions & State| ReactUI[React 19 / Next.js Client App]
    ReactUI -->|Game Logic & Loops| CustomHooks[Custom React Hooks]
    ReactUI -->|Low-Latency SFX| AudioEngine[Web Audio API Engine]
    ReactUI -->|HTTP / JSON| APIRoutes[Next.js / Node.js API Routes]
    APIRoutes -->|Mongoose ODM| MongoEngine[(MongoDB Database)]
    Client -->|Local Fallback| LocalStorage[(Client LocalStorage)]
    
    subgraph Frontend Layer
        ReactUI
        CustomHooks
        AudioEngine
    end

    subgraph Backend & Persistence Layer
        APIRoutes
        MongoEngine
        LocalStorage
    end
Loading

๐Ÿ›  Tech Stack

Domain Technology Purpose
Frontend Framework React 19 & Next.js Server-side rendering, component-driven UI, fast client navigation
Language TypeScript 5.9 Strict type safety, clean interface contracts, fewer runtime bugs
Styling & Design Tailwind CSS 4.0 Utility-first CSS, dark/light theme switching, responsive layouts
Backend & APIs Node.js & Next.js Route Handlers RESTful endpoints for game scores, session tracking, and user data
Database MongoDB & Mongoose Flexible document store for player profiles, game states, and leaderboards
Audio Processing HTML5 Web Audio API Real-time procedural tone generation and dynamic sound effects
Build & Bundling Vite / Next.js Bundler Fast HMR (Hot Module Replacement) and optimized production bundles
CI / CD GitHub Actions Automated linting, typechecking, and build validation on push/PR

โœจ Key Features

  • ๐ŸŽฎ 70+ Fully Playable Titles: Classic arcade hits, spatial puzzles, strategic board games, word challenges, and card tournaments built into one application.
  • ๐ŸŒ“ Dynamic Theming Engine: Smooth toggle between Dark Mode and Light Mode with zero flicker, synced with system preferences and local storage.
  • ๐Ÿ“Š Player Progression & Game History: Tracks recently played games, high scores, time spent, and game completion statuses.
  • ๐Ÿ”Š Procedural Sound Effects & Audio Controls: Toggleable volume, master mute, and synthesizers tailored for 8-bit retro audio.
  • ๐Ÿ” Instant Search & Multi-Tag Filtering: Debounced client search to query titles, descriptions, and category metadata in real-time.
  • ๐Ÿ“ฑ Responsive & Touch-Optimized: Fluid layouts supporting full keyboard controls (WASD/Arrows) and touch screens for mobile gaming.
  • ๐Ÿ›ก Defensive Error Handling: React Error Boundaries and graceful API fallbacks ensure single-game failures never crash the platform.

๐Ÿ•น Game Catalog Breakdown

Category Representative Titles Key Mechanics
๐Ÿ•น Arcade Asteroids, Pacman, Galaga, Space Invaders, Frogger, Dig Dug, Flappy Bird 2D Canvas rendering, collision detection, game loops
๐Ÿงฉ Puzzle Sudoku, Minesweeper, Sokoban, Sliding Puzzle, Lights Out, Nonogram Grid backtracking, constraint satisfaction, recursive flood-fill
โ™Ÿ Board & Strategy Chess, Checkers, Reversi, Connect Four, Battleship, Dots & Boxes Turn-based state machines, minimax AI, win-condition matrix checks
๐Ÿƒ Card Games Blackjack, Spider Solitaire, War Deck shuffling (Fisher-Yates), card animations, dealer rules
โšฝ Sports & Physics Air Hockey, Mini Golf, Bowling, Pool Table, Darts, Penalty Kicks 2D vector physics, velocity dampening, angle reflections
๐Ÿ“ Word Games Wordle, Word Search Dictionary validation, string indexing, letter frequency scoring

๐Ÿ“‚ Directory Structure

NOVAPLAY/
โ”œโ”€โ”€ .github/
โ”‚   โ””โ”€โ”€ workflows/
โ”‚       โ””โ”€โ”€ ci.yml               # GitHub Actions automated build pipeline
โ”œโ”€โ”€ public/
โ”‚   โ”œโ”€โ”€ logo.png                 # Platform branding
โ”‚   โ”œโ”€โ”€ manifest.json            # PWA manifest
โ”‚   โ””โ”€โ”€ sw.js                    # Service worker offline caching
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/              # Shared UI components (Modals, Nav, Cards)
โ”‚   โ”œโ”€โ”€ hooks/                   # Extracted business logic & custom hooks
โ”‚   โ”œโ”€โ”€ games/                   # 70+ modular game implementations
โ”‚   โ”‚   โ”œโ”€โ”€ AirHockey.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ Asteroids.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ ChessSimple.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ Sudoku.tsx
โ”‚   โ”‚   โ””โ”€โ”€ ...
โ”‚   โ”œโ”€โ”€ lib/                     # Database connections & server utilities
โ”‚   โ”‚   โ””โ”€โ”€ dbConnect.ts         # Cached MongoDB connection handler
โ”‚   โ”œโ”€โ”€ utils/                   # Helper functions, class merging (cn.ts)
โ”‚   โ”œโ”€โ”€ App.tsx                  # Main client shell & router
โ”‚   โ”œโ”€โ”€ gameCatalog.ts           # Game metadata registry
โ”‚   โ”œโ”€โ”€ gameGuides.ts            # Built-in tutorials & game instructions
โ”‚   โ”œโ”€โ”€ gameRegistry.ts          # Lazy-loaded component map
โ”‚   โ”œโ”€โ”€ toyAudio.ts              # Web Audio API engine
โ”‚   โ””โ”€โ”€ main.tsx                 # Client entry point
โ”œโ”€โ”€ .env.example                 # Sanitized environment variable template
โ”œโ”€โ”€ package.json                 # Project dependencies & scripts
โ”œโ”€โ”€ tsconfig.json                # TypeScript compiler config
โ””โ”€โ”€ vite.config.ts               # Vite build configuration

๐Ÿš€ Getting Started & Local Installation

Follow these steps to set up and run NOVAPLAY locally on your machine.

Prerequisites

  • Node.js: v18.x or higher (Download Node.js)
  • npm (comes with Node) or yarn / pnpm
  • MongoDB: Local MongoDB instance (mongod) or a free MongoDB Atlas Cluster
  • Git: Installed and configured

1. Clone the Repository

git clone https://github.com/your-username/novaplay.git
cd novaplay

2. Install Dependencies

npm install

3. Configure Environment Variables

Create your local .env file by copying the provided example:

cp .env.example .env

Open .env in your editor and configure your variables:

NODE_ENV=development
PORT=3000
MONGODB_URI=mongodb://localhost:27017/novaplay
NEXTAUTH_SECRET=your_secret_key_here

4. Start the Development Server

npm run dev

Open your browser and navigate to:

http://localhost:5173   # (or http://localhost:3000 depending on runner)

5. Production Build

To test the production build locally:

# Compile and bundle
npm run build

# Preview production build
npm run preview

๐Ÿ” Environment Configuration

All sensitive variables and runtime options are abstracted into .env. A complete template is provided in .env.example:

Variable Required Description Example / Default
NODE_ENV Yes Application environment mode development / production
PORT No Local server port 3000
MONGODB_URI Yes MongoDB connection string mongodb://localhost:27017/novaplay
MONGODB_DB_NAME No Database name novaplay
JWT_SECRET Yes Secret used for signing authentication tokens openssl rand -base64 32
NEXTAUTH_SECRET Optional NextAuth session encryption secret your_nextauth_secret
NEXT_PUBLIC_APP_URL Yes Canonical base URL of the client http://localhost:3000
NEXT_PUBLIC_API_BASE_URL Yes Base endpoint for API requests http://localhost:3000/api

๐Ÿ“ธ Screenshots & UI Showcase

(Add your high-resolution screenshots to /assets/screenshots/ and update the links below)

Catalog & Category Filter In-Game View (Arcade / Puzzle)
Catalog Preview Game View Preview
Light & Dark Theme Toggle Responsive Mobile View
Theme Showcase Mobile UI Preview

๐Ÿ”„ CI/CD Pipeline

This repository includes a continuous integration workflow powered by GitHub Actions located at .github/workflows/ci.yml.

  • Triggers: Push to main branch, and all Pull Requests targeting main.
  • Validation Steps:
    1. Automated checkout with clean Node.js runtime setup.
    2. Dependency caching via actions/setup-node.
    3. Strict package installation (npm ci).
    4. Typecheck & production build compilation (npm run build).

๐Ÿค Contributing

Contributions make the open-source community an inspiring place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'feat: Add AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License & Author

Distributed under the MIT License. See LICENSE for more information.

Author: Umesh Kumar Shah


Engineered with precision for performance and scalability. Star โญ this repository if you found it helpful!

About

Play 70+ exciting mini games in one place with NovaPlay. Jump straight into the action with no account creation or downloads needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages