Repository navigation
EN Reference Support Matrix
Français · Type: reference · Audience: player, admin, author, contributor · Context: player's browser, engine repository, created project, hosted Studio, Reality Bridge · Status: ready · Applies from: 4.4.0
What the automated gates run, and what only people check. The first table is the support matrix as the project keeps
it by hand; the sections after it are generated from the status registry,
docs/dev/contracts.json (npm run wiki -- generate reference.support-matrix): for
each product surface, five statuses kept apart. What "stable" and "experimental" promise is explained in
start.stability; how a person's pass is run, in contribute.field-passes.
Since 4.1.9 CI runs every row below on main and on every tag. A pull request runs the fast tier (lint, types, the
unit suite, the sample game's build and proof) and only the rows its change can affect, as
tools/ci-plan.ts classifies the diff: a docs-only pull request opens no browser, no Windows
runner and no Node 24 (contribute.ci).
Checked by CI (on main and tags; on a pull request when its change can affect it) |
Checked by people (not yet done) | |
|---|---|---|
| Player, phone | Chromium and WebKit at a phone's size, touch and keyboard, French; the PWA installed, updated after a durable save, reinstalled, in Chromium, WebKit and Firefox; the game opened offline (Chromium, Firefox) | a real Android phone, a real iPhone installed from Safari and updated, Safari offline on the device |
| Player, desktop | Chromium, mouse and keyboard | — |
| Player, screen reader | axe-core on every screen (not a WCAG claim) | a VoiceOver or NVDA pass |
| Firefox | the PWA only: install, update, reinstall, offline (npm run e2e:pwa, the pwa-firefox job); its worker's occasional refusal of one cached image offline is reported by the job, not counted |
Firefox offline on a real machine; nothing else claimed |
| Node | 22.12 or newer: 22 and 24 on Ubuntu; macOS for the maintainer's daily use | — |
| Windows | a windows-latest job (4.1.8; on a pull request, when code changed): doctor, the type checks, the unit suite but six files that assume POSIX (file modes, / in paths; named in ci.yml) and, since 4.1.9, the Telnet and SSH tests, and, since 4.2.1, the Studio Server's processing worker and its previews (Linux only), build, the production server answering |
npm run dev and the Studio on Windows; the six test files, ported |
| Python | optional: the art tools and the audio pipeline, Pillow, NumPy, SciPy pinned in requirements.txt
|
— |
| Reality Bridge | Node 22.12+, Chromium and WebKit e2e, a Rust cross-check of the protocol (SignalV2 included) |
a Bridge behind HTTPS with a real connector |
Bridge, local profile (4.1.10) |
SQLite through node:sqlite (Node 22.13+): the store contract, tenants crossed in property tests, three processes on one file with one killed during 1 000 proposals, backup as one snapshot and restore all or nothing (4.1.19); backup schema 4, whole-store and quota included, and two restore modes, merge and replace-store, under a maintenance lease (4.1.20); a load run of 50 000 proposals every night |
a long-running install on a real machine |
Bridge, distributed profile (4.1.10, experimental) |
Postgres 16 in CI (bridge-postgres): the same contract, tenants and fan-out between instances; the nightly load run; the qualification profile (ops/qualify/: HTTPS, three instances, the leaderboard, a worker killed mid-verification, a restore after the topology is destroyed) in the qualify workflow; since 4.1.20 the full profile in every candidate a tag may name (both restore modes under the maintenance lease), --short in a pull request's |
a real deployment: until one, experimental
|
| Connectors (4.1.9), experimental (D19) | email (signed webhook, IMAP), Telnet, SSH, Open Badges 2 and 3: the same contract on all four, abuse and fuzz tests, a run under --disallow-code-generation-from-strings, the sample chapter's replays; the four played from their archive in the candidate (4.1.19); Telnet and SSH tests not on Windows yet |
a real email provider, a real badge from a real issuer, SSH and Telnet exposed in a controlled environment |
| Documentation (4.5.0), experimental |
npm run wiki -- check on every change (links and anchors, both languages alike, the generated references against the code, the transition pages of docs/); the acceptance questions (wiki -- acceptance --strict); the bundle in the package, read through MCP from a project installed outside the repository (external-consumer) |
a beginner reading it to make a first game (docs-beginner-reader) |
Limit ·
matrix-scopeA row says what is checked, not more: a browser, a platform or a deployment the matrix does not name is not checked by CI, and a "checked by people" cell stays open until its pass is done for the version you run.
Each surface below gives, apart: its contract (experimental, stable or deprecated), the environments CI verifies for it (as of the support matrix the registry quotes), the automated checks that cover it (ci:plan's gates, CI and candidate jobs, test files), the checks by people it waits for (their state in that version's pass sheet, and the issue that tracks each), and where its known limits are. A page of this wiki that documents a surface shows the same five statuses in its header.
- Contract: stable (
content-format). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Node 22 and 24 on Ubuntu; Windows (windows-latest): the unit suite but six POSIX files.
- Automated checks: ci:plan gates
node24,windows,secondGame,freshInstall,upgrade,reference; CI and candidate jobscheck,coverage,second-game,upgrade; test filestests/validate-stage.test.ts,tests/solver-contract.test.ts,tests/save-v3.test.ts,tests/hero-choice.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
heroes-two-languages: not run yet, #237.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
public-api). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Node 22 and 24 on Ubuntu.
- Automated checks: ci:plan gates
node24,freshInstall; CI and candidate jobscheck,external-consumer; test filestests/api-surface.test.ts,tests/api-doc.test.ts. - Checks by people: none asked.
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
player-dom). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Chromium on the desktop, mouse and keyboard; Chromium and WebKit at a phone's size, touch and keyboard (emulated); axe-core on every screen (not a WCAG claim).
- Automated checks: ci:plan gates
e2e; CI and candidate jobse2e; test filestests/dom/a11y.test.ts,tests/dom/presenter.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md): - Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: experimental (
player-canvas). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Chromium in CI, the same game drawn and played.
- Automated checks: ci:plan gates
e2e; CI and candidate jobse2e; test filestests/dom/render-canvas.test.ts,tests/dom/renderer-contract.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
phone-both-renderers: not run yet, #83.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
pwa). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Chromium, WebKit and Firefox: installed, updated after a durable save, reinstalled; Offline in Chromium and Firefox.
- Automated checks: ci:plan gates
e2e,pwaFirefox; CI and candidate jobse2e,pwa-firefox; test filestests/offline.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md): - Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
bridge-local). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Node 22.13+ with node:sqlite, on Ubuntu; Chromium and WebKit end to end.
- Automated checks: ci:plan gates
reality; CI and candidate jobsreality,reality-xcheck; test filestests/bridge-store.test.ts,tests/bridge-backup.test.ts. - Checks by people: none asked.
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: experimental (
bridge-distributed). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Postgres 16 in CI; The qualification profile: HTTPS, three instances (ops/qualify/).
- Automated checks: ci:plan gates
reality; CI and candidate jobsbridge-postgres,deployment-smoke; test filestests/bridge-postgres-isolation.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
bridge-postgres-https: not run yet, #77.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: experimental (
connectors). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Node 22 on Ubuntu (Telnet and SSH not on Windows).
- Automated checks: ci:plan gates
reality; CI and candidate jobsconnectors,connector-archive-e2e; test filestests/connectors-sdk.test.ts,tests/connectors-email.test.ts,tests/connectors-ssh.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
connectors-real-security: not run yet, #79.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
speedrun-remix). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Replays in four runtimes (cross-runtime).
- Automated checks: ci:plan gates
e2e; CI and candidate jobscross-runtime,e2e; test filestests/speedrun-verify.test.ts,tests/remix-worlds.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md): - Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
voices-music). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): The music director in Chromium and WebKit.
- Automated checks: ci:plan gates
e2e; CI and candidate jobse2e; test filestests/voices.test.ts,tests/voice-locale.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
voices-listening: not run yet, #87.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
archives-install). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Installed outside the repository on Ubuntu (Node 22 and 24), macOS and Windows.
- Automated checks: ci:plan gates
freshInstall; CI and candidate jobsexternal-consumer,fresh-install; test filestests/pack-locks.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
archive-human-install: not run yet, #75.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: stable (
studio-local). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Chromium end to end (the Studio's checks); Windows: the unit suite only.
- Automated checks: ci:plan gates
e2e,windows; CI and candidate jobse2e,windows; test filestests/hero-matrix.test.ts,tests/studio-assistant.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
studio-hero-matrix: not run yet, #238.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: experimental (
studio-server). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): Postgres, S3 and Keycloak in CI; Chromium and Firefox (job studio-hosted); WebKit on macOS, by hand only.
- Automated checks: ci:plan gates
studioHosted; CI and candidate jobsstudio-hosted,studio-install-smoke; test filestests/studio-server.test.ts,tests/studio-backup.test.ts,tests/studio-collab.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md): - Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
- Contract: experimental (
documentation). - Environments CI verifies (support matrix of 4.4.0, 2026-10-23): none named.
- Automated checks: CI and candidate jobs
check,external-consumer; test filestests/wiki-manifest.test.ts,tests/wiki-check.test.ts,tests/wiki-access.test.ts,tests/wiki-proofs.test.ts,tests/wiki-acceptance.test.ts,tests/mcp-docs.test.ts. - Checks by people (states from
docs/dev/passes/4.4.0.md):-
docs-beginner-reader: not asked of this version.
-
- Known limits: the
[!LIMIT]blocks of the pages that name this surface in the manifest (surfaces).
Generated publication · publication générée — current documentation · documentation courante: quest'n'click 4.4.0 r1, documentation revision · révision de la documentation 8dc717c69acb62c4742b69c54a7e7dfb620f75d8.
Earlier versions and permalinks · versions précédentes et liens permanents: https://wanoo.github.io/quest-n-click/docs/
An edit made in this wiki is overwritten at the next publication · une modification faite dans ce wiki est écrasée à la publication suivante.
Edit the source · Modifier la source · Report an error · Signaler une erreur
Index (6)
Start (6)
Play (9)
Install (17)
- Requirements
- Install from the release archive
- Install from npm, once published
- Install from the repository to work on the engine
- doctor: checking your machine
- Image toolchain
- Audio toolchain: ffmpeg, fluidsynth, Furnace, uv
- Upgrade
- Upgrade notes: 4.4
- Upgrade notes: 4.3
- Upgrade notes: 4.2
- Upgrade notes: 4.1
- Upgrade notes: v3
- Upgrade notes: v2 to v3
- Coming from web-scumm
- Package reference
- Install troubleshooting
Create a game (55)
- Your first game
- Layout of a created project and of the engine repository
- The working loop
- Content principles and the identity contract
- Rooms
- Geometry: placement, walk zones, masks, layers, camera
- Something is visible but unreachable
- Reactions
- Game commands
- Conditions
- Flags, variables and events: which to use
- Custom code
- Characters
- Items and inventory
- World map
- Dialogues
- Scripts and events
- Moving characters: patrols and walks
- Exits
- Chapters and objectives
- State and saves: persistent or temporary, renaming an id, migrations
- Staging: wide rooms and animations
- The stage: lights, particles, floors
- Skin and fonts
- Title and credits
- Heroes: several characters and hero choice
- Built-in minigames
- A custom minigame
- Translations
- Music in stems
- Sound effects
- Voices: per language and per hero
- Images: prompts, cutting sheets, transparency, scale
- Asset provenance
- The storyboard, source of truth
- Puzzle design
- Classic mechanics
- Review pages
- DSL reference
- Checking your game
- What the solver proves
- Solver options
- Playtests
- Remix
- Speedrun for authors
- The sealed ending
- Production template
- Example games
- Working with an AI
- Build and release a game
- Publish on GitHub Pages
- The static game on Clever Cloud
- Other static hosts
- Sub-path, cache and service worker, incomplete deploys, going back
- Testing on a phone over the LAN
Local Studio (24)
- The local Studio: overview and launch
- Edit a room
- Placement and stage
- Preview, apply, undo
- Storyboard
- Assets and cutting
- Check: validator, solver, critical path, heat, health, coverage
- Before and after captures
- Semantic diff
- Play and replay a session
- Rule explainer
- Language and objectives
- Voices and the heroes × languages matrix
- Map
- Notes
- Remix in the Studio
- Music
- The Assistant: bring your own key
- Demo mode and studio-apply
- Local and LAN security
- Studio API
- Local MCP: setting up each client
- MCP tools
- Studio troubleshooting
Team Studio (21)
- What runs where
- Concepts: revision, transaction, span, lease, preview, build
- Starting as an invited dev
- Working together day to day
- Roles and actions: the full matrix
- Invitations
- Managing members
- Write refused on the hosted Studio: stale base revision (409)
- Write refused on the hosted Studio: span locked (423)
- Recovering after a lost lease, a disconnection or a stale preview
- Comments
- Map and semantic diff
- Publishing builds
- Remote MCP
- The game in Git
- Upgrading the engine of a hosted game
- Hosted assets
- The server's command line
- Health and metrics routes
- Trying it locally with compose.yml
- Known limits
Clever Cloud (23)
- Clever Cloud: overview, cost and prerequisites
- Apps and add-ons
- Domains and TLS
- Keycloak
- Generic OIDC and GitLab
- Configuration
- First deployment
- Backups
- RPO and RTO
- Restore the Studio on a fresh installation
- Redeploys
- Upgrading the server and checking state after a migration
- Limits of going back
- Monitoring
- Security
- Rotating keys
- Recovering admin access
- Changing domain or OIDC provider
- Worker, PostgreSQL or Cellar down
- Exporting the game and leaving the installation
- Retention
- Clever Cloud troubleshooting
- Costs and teardown
Reality Bridge and connectors (16)
- The Reality Bridge: what it is
- Quick start
- Guarantees
- Install and run the Bridge
- Backup and restore
- Several tenants
- Signals and the manifest
- The Bridge's command line
- Connectors overview
- Email connector
- Telnet connector
- SSH connector
- Open Badges connector
- The connector SDK
- Security: Biscuit and signatures
- Bridge and connector troubleshooting
Contribute (25)
- Welcome
- Developer setup
- The dev loop
- Before a pull request
- Conventions
- Writing documentation
- Architecture
- Code tour
- Import boundaries
- Which tests run when
- Mutation testing
- The coverage ratchet
- The quality baseline
- CI explained
- Field passes
- Benchmarks
- Releasing
- npm packages
- Decisions and ADRs
- Governance
- Bot pull requests
- Contributing with AI agents
- Security policy
- Code of conduct
- Licences and credits