KhelZon

KhelZon is a browser-based single-player arcade built with HTML, CSS, and JavaScript. It runs without frameworks, build tools, or user accounts, and stores scores locally on each device.

Live demo: khelzon.pages.dev

Overview

• Twelve original single-player games across Strategy, Arcade, Puzzle, Action, and Reflex
• Welcome lobby with arcade entry, about section, and multi-profile player management
• Light and dark themes with locally persisted preference
• Progressive Web App with offline support and optional installation
• Per-player score tracking with export and import backup

Games

Game	Type	Description
Marble Quest Solo	Strategy	Card-driven marble race against CPU (Jackaroo-inspired)
Territory Clash	Strategy	Expand grid territory vs CPU
Snake Rush	Arcade	Classic snake with progressive speed
Neon Dodge	Arcade	Dodge falling blocks in three lanes
Orbit Breaker	Arcade	Breakout-style brick smasher
Number Cascade	Puzzle	Merge tiles to reach 4096
Memory Matrix	Puzzle	Match pairs against the clock
Slide Quest	Puzzle	Sliding tile puzzle (1–8)
Star Drift	Action	Space shooter through asteroid waves
Meteor Run	Action	Dodge meteor shower survival
Tap Sequence	Reflex	Repeat an expanding color pattern
Target Tap	Reflex	Tap targets before they vanish

Getting Started

Play online: https://khelzon.pages.dev

For local development, ES modules require a HTTP server.

git clone https://github.com/pradipNP/khelzon.git
cd khelzon
python -m http.server 8080

Open http://localhost:8080. The application loads the lobby first; select Enter Arcade to reach the game dashboard.

Alternative local servers: npx serve . or the VS Code Live Server extension.

Progressive Web App

KhelZon registers a service worker for asset caching and supports installation as a standalone app.

Platform	Installation
Desktop / Android	Use Install App in the lobby or the install control in the header
iOS (Safari)	Share → Add to Home Screen

HTTPS is required for installation and service worker registration in production.

Data & Privacy

All player profiles and scores are stored in the browser via localStorage. No authentication or remote database is used.

Capability	Behavior
Multiple profiles	Separate score sets per profile on the same device
Cross-tab updates	Changes propagate between open tabs automatically
Backup export / import	JSON file for manual transfer between browsers or devices
Browser sync	Optional; depends on Chrome or Firefox sync settings

KhelZon does not transmit score data to external servers unless the user explicitly exports a backup file.

Deployment

KhelZon is a static site. Deploy the repository root to any static hosting provider.

Setting	Value
Build command	None
Output directory	/ (repository root)
Requirements	HTTPS for PWA features

Compatible hosts include Cloudflare Pages, Netlify, Vercel, and GitHub Pages. After the first online visit, the service worker caches application assets for offline use.

Project Structure

KhelZon/
├── index.html
├── manifest.json
├── sw.js
├── css/
│   ├── main.css
│   └── games.css
└── js/
    ├── app.js
    ├── router.js
    ├── lobby.js
    ├── theme.js
    ├── pwa.js
    ├── sync.js
    ├── storage.js
    ├── gameRegistry.js
    ├── gameFit.js
    ├── users.js
    └── games/

Technology

• Vanilla ES modules
• Canvas 2D for action games
• CSS Grid and Flexbox
• LocalStorage for persistence
• Service Worker for offline caching

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, coding guidelines, and pull request expectations.

• Report a bug
• Request a feature
• Propose a game

Please read CODE_OF_CONDUCT.md before participating.

License

MIT — Copyright (c) 2026 Pradip Kumar Prajapati.