Skip to content
Q9LabsPublic

Latest commit

 

History

2,017 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chalk

Chalk is an open-source monorepo for low-latency real-time collaboration and communication with the Chalk SFU. A Space is the durable place where Users and Agents participate; each bounded run is an Episode that can leave Recording and Transcript artifacts. The repository contains the Go control-plane API, Elixir SyncEngine, TypeScript/React/React Native SDKs, first-party web and mobile surfaces, reusable whiteboard/UI packages, and supporting infrastructure.

Project documents

  • Theory — intent, product model and boundaries.
  • Tracker — outcomes and remaining work.
  • tracker.yaml — the only editable outcome inventory.
  • Design — visual system and Google Stitch generation guidance.

Development

Install Git, Node.js, pnpm, and Docker Desktop, OrbStack, or Docker Engine. API, Sync, Postgres, and Redis run in containers on macOS, Linux, and Windows. Go, Elixir/Erlang, and OpenSSL are not host prerequisites.

Follow Run Chalk locally for OS-specific setup, the non-production SFU credential, Android, tests, and the PR workflow.

pnpm install --frozen-lockfile
pnpm dev

Wait for Chalk dev ready, then open the printed web URL. Use pnpm dev --profile android to add Metro. Inspect the stack with pnpm dev:doctor, pnpm dev:smoke, and pnpm dev:logs. Stop it with pnpm dev:stop, or remove its local runtime data with pnpm dev:down.

Run pnpm gate before submitting a change. Open a draft PR, finish checks and self-review, then check the ready cap before marking it ready. See gate operations.

License

MIT. See LICENSE.

Tracker workflow

Edit tracker.yaml, then run pnpm generate:tracker. pnpm check:tracker validates states, priorities, sizes, source references and generated-view freshness as part of the canonical gate.

Do not edit the generated Markdown view.

Releases

Packages

Used by

Contributors

Languages