neaI.fun

Games and stuff: a small hub of self-contained interactive toys and mini-games. Built with Next.js (App Router), React 19, TypeScript and Tailwind CSS v4, and deployed as a static site on GitHub Pages.

In code the project is called playground (package name, localStorage prefix), since neaI.fun is awkward to type.

Getting started

npm install
npm run dev

Open http://localhost:3000.

Script	What it does
npm run dev	Dev server with hot reload
npm run build	Static export into out/
npm run lint	ESLint (Next.js core-web-vitals + TypeScript)

Games

Game	URL
Stack	/stack
Click Sprint	/click-sprint
Color Match	/color-match

Documentation

• Architecture: folder map, how pages are built, state, conventions
• Styling: tokens, shared classes, per-game themes, fitting the screen, home tiles
• Sound, vibration and animation: the shared feedback toolkit
• Adding a game: step-by-step guide and checklist
• Deployment: GitHub Pages pipeline and config

At a glance

src/
  app/            Routes: home + one folder per game (app/stack/page.tsx -> /stack)
  games/          One folder per game (manifest, Game, Thumbnail, README, ...)
  components/     Logo, GameTile, GameScreen, Confetti
  styles/         Shared CSS: tokens, base, components, animations
  lib/            storage, sound/sfx, haptics, small hooks, cn
docs/             Project documentation