Air Jam

Open source React framework and platform for multiplayer party games with smartphones as controllers.

What Air Jam Is

Air Jam lets you build multiplayer games where:

the host runs on a laptop, desktop, or TV
players join instantly by scanning a QR code
smartphones become game controllers in the browser
you ship without native mobile apps or app-store installs

It is designed for party games, couch multiplayer, installations, classroom games, playtesting, and AI-assisted game iteration.

What You Get

@air-jam/sdk for controller input, replicated state, runtime helpers, and host/controller contracts
@air-jam/server for real-time multiplayer session handling
@air-jam/mcp-server for agent and tooling integration
create-airjam for scaffolding new games from production templates
airjam.io for docs, hosted games, and the Arcade catalog

Create A Game

npx create-airjam@latest my-game
cd my-game
pnpm install
pnpm run dev

Choose a template explicitly if you want a stronger starting point:

npx create-airjam@latest my-game --template pong
npx create-airjam@latest my-game --template air-capture

Then open the host locally, scan the QR code with your phone, and start playing.

Why Air Jam

No controller app download
Real-time multiplayer built for room-scale play
Strong host/controller contracts instead of ad hoc browser glue
React + TypeScript + Zod end to end
First-party reference games you can actually learn from
A path toward AI-native game creation, testing, and publishing workflows

Public Packages

Air Jam’s supported public npm surface is intentionally small:

Everything else in the monorepo should be treated as internal implementation detail.

Repo Development

If you want to work on Air Jam itself:

git clone https://github.com/vucinatim/air-jam.git
cd air-jam
pnpm install

Useful top-level workflows:

pnpm arcade:dev --game=air-capture
pnpm standalone:dev --game=pong
pnpm arcade:test --game=code-review
pnpm logs --view=signal

For the normal quality gate:

pnpm check:ci

For the full local release gate:

pnpm check:release

For maintainers and agents executing the active 1.0 program:

pnpm run repo -- readiness --help
pnpm --silent run repo -- readiness status --json
pnpm --silent run repo -- readiness next --json

Monorepo Shape

apps/
  platform/        airjam.io platform, docs, dashboard, Arcade
games/
  ...              first-party games and scaffold sources
packages/
  sdk/             public game framework
  server/          public realtime server
  mcp-server/      public MCP surface
  create-airjam/   public scaffolding CLI

Documentation

Contributing

Issues, discussions, documentation improvements, SDK improvements, reference games, and tooling work are all welcome.

Before opening a PR:

run pnpm check:ci
keep changes focused
update docs when behavior or contracts change

License

MIT