DarkCircle Suite Docs
Docs / The portal

The WebGL portal

index.html is the real-time 3D front door to the suite. A black obsidian orb hovers inside a crimson-lit octagonal containment vault, wrapped in a ring of plasma. The six apps ride a carousel round the orb; the node at the front haloes the orb and is the selected app.

Controls

InputAction
DragOrbit the chamber
‹ › arrows, ← →Spin the carousel one app either way
Click a side nodeSpin it to the front
Click the front node (the orb), EnterWarp transition into the selected app
Click a card or pill, 1–5Spin that app to the front, then warp: DarkCircle, Circleswap, DarkSafe, Dark Questate, DarkOrder
Hover a nodeTelemetry readout: node, route, live Cyprus-1 block height
Sound buttonMusic and synthesized cues (Web Audio, muted by default)
Book buttonOpens this documentation
Phone tiltParallax (iOS asks for permission on first touch)
?mode=2dForce the 2D card portal

It opens on Circleswap in front, DarkCircle and DarkSafe to either side, and Dark Questate and DarkOrder behind the orb. Tap the BOLTEVM logo for a new world color.

Graceful degradation

No WebGL, a failed GPU context, a missing model file or prefers-reduced-motion all land on a working 2D portal or a calmer 3D one. The links are plain anchors, so navigation never depends on the 3D engine. In the 2D portal the arrows still work: they move the highlight across the cards, and Enter opens the highlighted app.

Privacy

The portal loads nothing from a third-party host: three.js and every add-on are vendored under assets/3d/vendor/, and there are no web fonts. The only network call is a single read-only quai_blockNumber to rpc.quai.network, made the first time you target a node or spin the carousel, with credentials and referrer omitted. The bottom bar shows its state (RPC idle, querying, CYPRUS-1 #...).

Subdomain and path routing

Host starts withGoes to
q0. circleswap. or contains q0-/q0/
darksafe. safe. multisig. or contains darksafe-/multisigows/
tumbler. privacy. x402. or contains tumbler-/x402tumbler/
questate. darkquestate. realestate. or contains questate-/darkquestate/
darkorder. guild. halls. or contains darkorder-/darkorder/

404.html applies the same rules to deep links and keeps the /<repo>/ prefix on GitHub project pages. A deep link under /questate/ goes to /darkquestate/; a deep link under /guildhalls/ goes to /darkorder/.

The 3D asset

SpaceY-up, metres. Orb centre at (0, 1.7, 0), radius 0.5. Room: 14.8 m across, 4.6 m high
Sizeabout 24k triangles, 790 KB .glb, 10 PBR materials, no textures
Lights7 punctual lights, exported unitless (COMPAT) so three.js does not blow out
AnimationFour 5-second loop clips: orb hover, plasma spin, plasma sweep, camera push
ReferenceProportions measured from the QRB artwork q0/QgoGIF.gif
SourceRebuilt from code by tools/build_qrb_scene.py; verified by tools/verify_qrb_assets.mjs
Note

Both index.html and 404.html must stay pure ASCII; CI fails on any non-ASCII byte (the first build shipped corrupted dashes and emoji — emoji are written as HTML entities instead).