A small, open-source game platform: a generic engine for running any kind of puzzle or strategy game in a browser, plus a curated collection of games that use it.

Luca powers CatoBigato's game section but is designed to be consumed by any web app. It is two npm packages:

Games are surprisingly hard to integrate well:

• State machines need to handle win/loss, persistence, keyboard input, and help overlays — these are the same for every game.
• Apps want to own their theming, auth, and routing.
• Multiple consumers (CatoBigato, third-party apps, future mobile) want the same games without re-implementing them.

Luca splits along the line "things every game needs" (engine) vs "the actual games and their gallery" (platform). CatoBigato is one consumer; other apps can embed either layer.

v0.1.0 — public preview. Both packages are published to the public npm registry under the @luca-game scope. See docs/STATUS.md for the roadmap.

# Embed a single game in any React app
npm install @luca-game/engine @luca-game/platform

import { GameEngine } from '@luca-game/engine'
import { sudoku } from '@luca-game/platform/games'

function MySudokuPage() {
  return <GameEngine definition={sudoku.definition} className="sudoku" />
}

For the full gallery + completion API:

# (still installing both packages)
import { Gallery, PlayPage, CompletionProvider, LocalCompletionClient }
  from '@luca-game/platform'
import { httpClient } from './my-api'

function GamesSection() {
  return (
    <CompletionProvider client={httpClient}>
      <Gallery />
      <PlayPage />
    </CompletionProvider>
  )
}

See docs/ARCHITECTURE.md for the full design, including:

• Engine vs platform boundary
• The GameDefinition<TState, TAction, TStats> contract
• Per-game module shape
• The completion / resolve API

See docs/GAME_DEFINITION.md. Each game lives under packages/platform/src/games/<slug>/ and exports:

export { definition } from './myGameDefinition'
export { default as Component } from './MyGame'
export { default as meta } from './meta'

Then register it in packages/platform/src/registry.ts.

MIT — see LICENSE. Free to use, modify, and distribute.