|
| 1 | +# Orbit home and playground |
| 2 | + |
| 3 | +## Evidence |
| 4 | + |
| 5 | +Primary references: the user's current home at https://zumerlab.com/orbit-docs/ |
| 6 | +(dark blue, blue/coral arcs, concentric ticks and an orbital composition), and |
| 7 | +the verified `orbit/examples/playground.html` (direct manipulation and real code). |
| 8 | + |
| 9 | +UIZZE catalogue searches exposed metadata for three relevant editing screens: |
| 10 | + |
| 11 | +- [Whop tutorial editor](https://uizze.com/screens/69ac7efa003848282eff): select |
| 12 | + the subject before editing it. Transfer recipe navigation, not course branding. |
| 13 | +- [Wix post design](https://uizze.com/screens/6999d52a001d656e575d): scoped settings |
| 14 | + and explanatory states. Transfer disclosure of code, not the business content. |
| 15 | +- [Apollo filters](https://uizze.com/screens/6995634a0013a4ec6281): explicit grouped |
| 16 | + parameters. Transfer control grouping, not CRM fields or density. |
| 17 | + |
| 18 | +Evidence limitation: indexed descriptions were available, but direct screen |
| 19 | +requests returned 410. Their visual layouts were not verified. The user's own |
| 20 | +home and working playground govern the actual visual treatment. |
| 21 | + |
| 22 | +User revision: keep the established layout and colors, use the original docs logo, |
| 23 | +and remove decorative numbering, spaced uppercase labels and monospace UI text. |
| 24 | +The [sci-fi example](http://127.0.0.1:4326/orbit-docs/examples/scifi/) supplies the |
| 25 | +separate depth layers. The user's [SnapDOM reference](https://snapdom.dev/showcase/#orbit) |
| 26 | +supplies the automatic tilt: a slow rotation around both X and Y axes. Preserve |
| 27 | +the satellite control and add pause/resume; no pointer movement is required. |
| 28 | + |
| 29 | +## Contract |
| 30 | + |
| 31 | +| Field | Decision | |
| 32 | +| --- | --- | |
| 33 | +| Job | Understand radial composition, change it and leave with working code. | |
| 34 | +| User/action | Developer adjusts a live parameter, then copies or downloads the composition. | |
| 35 | +| Hierarchy | Purpose + live branded composition; playground; editable recipes; installation/docs. | |
| 36 | +| Navigation | Visible Playground, Examples, Docs, GitHub; existing docs URLs preserved. | |
| 37 | +| Visual language | Existing #060f16, #3da9fc, #ef4565 and original docs SVG logo; real Orbit geometry; Arial for UI and compositions, monospace only for code; sentence case labels without numbering; thin rules and space around the compositions. | |
| 38 | +| States | Zero, 80 satellites, reorder, recipe selection, mobile preview/code, copy/export loading/success/failure, reset. | |
| 39 | +| Responsive | Desktop preview beside settings/code; mobile preview/code views, native labelled controls, reachable navigation. | |
| 40 | +| Motion | Layered hero tilts automatically in 3D, with pause/resume and live satellite count. Reduced-motion prevents autoplay. Suspend animation offscreen and in hidden tabs. | |
| 41 | +| Forbidden | Invented logos, numbered section labels, uppercase micro-labels, generic slogans, invented adoption metrics, unrelated illustrations, forced signup, decorative dashboard cards. | |
| 42 | +| Acceptance | Useful controls above fold on desktop; no 360px overflow; keyboard/focus support; source matches preview; standalone export runs offline; docs/search/mobile nav work. | |
| 43 | + |
| 44 | +## Runtime |
| 45 | + |
| 46 | +Home, docs previews and exports share a verified Orbit snapshot. Its manifest |
| 47 | +records source revision and hashes because npm currently has the same version |
| 48 | +number with older code. Astro/Starlight build the site; interactions use plain JS. |
| 49 | + |
| 50 | +## Verification |
| 51 | + |
| 52 | +Validated against the production build on 2026-09-05: |
| 53 | + |
| 54 | +- Node 24 type checking and production build pass; npm audit reports no vulnerabilities. |
| 55 | +- All 60 existing routes and 101 local link/asset targets resolve, including anchors. |
| 56 | +- Chromium, Firefox and WebKit pass the playground and documentation editor flows. |
| 57 | + First pointer and keyboard edits work in WebKit without focusing or scrolling on load. |
| 58 | +- All nine recipe/browser exports run from `file://` without network access; |
| 59 | + Chromium clipboard content matches the downloaded HTML. Export failures recover. |
| 60 | +- Keyboard tabs, reset, zero/full values, 80 satellites and reduced motion work. |
| 61 | +- Desktop, tablet and mobile layouts were visually inspected. No horizontal page |
| 62 | + overflow at 360, 390, 768, 1280 or 1440 pixels. Search and mobile navigation work. |
| 63 | +- Both copies of all five Orbit runtime files match the recorded SHA-256 hashes. |
| 64 | + |
| 65 | +User revision checks: |
| 66 | + |
| 67 | +- The header and hero load the original docs SVG, with its existing color and proportions. |
| 68 | +- UI text and compositions use Arial. Monospace remains only in source code; |
| 69 | + section/tab numbering and promotional slogans were removed. |
| 70 | +- The hero's seven depth layers tilt automatically on an 18-second loop. |
| 71 | + Chromium, Firefox and WebKit pass pause/resume, satellite changes, offscreen |
| 72 | + suspension, persistent manual pause and initial/live reduced-motion checks. |
| 73 | +- Nine animation phases at 360, 390, 768 and 1440 pixels produce no horizontal |
| 74 | + page overflow. Desktop, tablet and mobile views were inspected visually. |
| 75 | +- The tablet preview reserves space below the composition for its caption. |
| 76 | +- The hidden-tab handler was checked by simulating document visibility in |
| 77 | + headless browsers; pagehide/pageshow suspension was also checked. |
| 78 | + |
| 79 | +Release boundary: this is a local site build. The bundled Orbit snapshot includes |
| 80 | +the fixes; the existing npm 1.4.12 release does not. Publish a new package version |
| 81 | +and run `npm run sync:orbit` before removing the pending-release documentation. |
0 commit comments