Svelte + Threlte component library and CLI scaffold for building 3D mini-games.
josh-gameCLI — scaffold a new SvelteKit + Threlte game project from a working template.- Library exports — drop-in scenes, player, controls, switches, and reactive state primitives for use inside any SvelteKit app.
- Node.js with pnpm ≥ 11
- gh CLI — required for GitHub Packages authentication. Install via
brew install gh(macOS),winget install GitHub.cli(Windows), or see the gh installation docs.
gh auth login --scopes read:packages # see docs/authentication.md for the full setup
pnpm add -g @joshuafolkken/game-kit
josh-game init my-game
cd my-game && pnpm dev # open the URL it prints (http://localhost:5173 by default)| Guide | What it covers |
|---|---|
| authentication.md | One-time GitHub Packages auth — gh token, NODE_AUTH_TOKEN, .npmrc |
| install.md | Scaffold a new game project with josh-game init |
| library.md | Use @joshuafolkken/game-kit as a library in an existing project, with the full export list |
| troubleshooting.md | Fixes for 401/404 auth errors, josh-game: command not found, and other common failures |
See CONTRIBUTING.md for the development workflow and coding conventions. Community standards live in CODE_OF_CONDUCT.md; security reports go through SECURITY.md.
MIT