🌌 Cosmos Atlas¶
"What I had in mind was an abstract — like dots or logos circling the sun with physics. Users can click or zoom into a planet — it will reveal the moon and a card showing what that planet is. Lively, highly interactive, very bold and ambitious." — Sush, 8 May 2026 NZST
Live at: cosmos.aguidetocloud.com · Repo: susanthgit/cosmos-atlas
The Cosmos Atlas is a planet in the cosmos — a neutral overlook that maps the whole universe. Unlike Earth, CMD, Shift, Plain AI, Agentic, and Claw — which each serve a distinct audience with distinct content — the Atlas serves first-time visitors who need orientation across the cosmos in 30 seconds, without reading.
What you see¶
An interactive solar-system visualisation:
- A central source (the AI co-founder Sun, per Cosmos Philosophy — invisible pulsing glow)
- 7 worlds orbiting in 3D-tilted concentric ellipses (38° tilt, perspective focal 900)
- Moons orbiting their parent planets (Guided around Earth, Plain AI Curriculum around Plain AI)
- The MCP star pinned in the upper-right as the cosmos's machine-readable surface
- Decorative starfield + MCP starfield in the background
- Click any body → camera glides in, planet expands, card slides in with ≤100 words on what it is, who it's for, and where to visit
- Static
?view=listfallback (the SSR semantic HTML) for accessibility, SEO, low-bandwidth, and bots — toggle in HUD as "📋 List view"
The Atlas does not list individual tools, certs, blog posts, or mind maps. Each planet's own site does that. Atlas's job ends at the planet.
Atmosphere — Deep Cosmos¶
Locked 8 May 2026 with Sush:
| Property | Value |
|---|---|
| Background | #02030E (almost-black, cool undertone) |
| HUD chrome | #F2EDE3 (Apollo-Eno warm white) |
| Accent | #FFB347 (scientific-instrument amber) |
| Display font | Space Grotesk (self-hosted via @fontsource Latin) |
| Mono font | JetBrains Mono (self-hosted) |
| Sun | Invisible pulsing glow — no glyph, no label |
| Tilt | 38° around screen-x-axis (3D perspective) |
| Sound | None in v1 (deferred to v2 — licensing + opt-in UX) |
| 3-question router | Permanently skipped — cosmos IS the navigation |
Tech¶
- Astro 5.18 (static output, SSR HTML for SEO/a11y)
- Canvas 2D (orbits + sun glow + body halos + starfield)
- HTML overlays for planet logos (crisp SVG at any zoom, native pointer events)
- Vanilla CSS +
requestAnimationFrame(no GSAP, no Three.js) - TypeScript strict for the canvas controller
- Deploy: direct-upload to Cloudflare Pages via
node deploy.mjs(BLAKE3 hashes + Pages API)
Planet logos¶
Real planet logos orbit (vendored from the canonical 7-icon cosmos rail contract):
- 🌍 Earth — lotus webp
- 🌑 Guided — crescent moon SVG
- 🪐 CMD —
$_with blinking cursor - 🪐 Shift — newspaper dial with sweeping needle + pulsing red sector
- 🪐 Plain AI — cyan→purple→pink AI gradient bubble
- 🌑 Plain AI Curriculum — green seedling (atlas-internal, matches
🌱 free foreverbrand) - 🪐 Agentic — pulsing cockpit dot
- 🪐 Claw —
[*]red asterisk in brackets - ⭐ MCP Star — 8-ray amber pulsing burst (atlas-internal)
Status¶
| Phase | Status |
|---|---|
| Vision lock + atmosphere call | 🟢 LOCKED 8 May 2026 |
| Phase 0 + 1 (scaffold + data + voice-passed cards) | 🟢 SHIPPED commit 658ab59 |
| Phase 2 (real planet logos + 3D tilt + richer cards) | 🟢 SHIPPED commit e9e8583 |
| Self-hosted fonts | 🟢 SHIPPED commit f0042bc |
Deploy script (npm run deploy) |
🟢 SHIPPED commit 1be8c63 |
| Cloudflare Pages project + DNS + SSL | 🟢 LIVE at cosmos.aguidetocloud.com |
| v1.1 polish (transparent lotus, halo tightening, hover-pause + hover-dim, mobile auto-list, hit-zone) | 🟢 SHIPPED commit 98a5f27 (8 May 2026 evening) |
| v2 backlog | ⚪ See v2-roadmap.md |
Cosmos contracts¶
| Contract | Status |
|---|---|
Reads planets.json (vendored from Earth's mirrors) |
✅ Live (read-only) |
Owns atlas.json (orbit + cards + atmosphere) |
✅ Live |
| Receives back-link from each planet's footer | ⏳ Phase 12 — deferred until parallel voice/logo/nav/parity sessions land |
Atlas added to planets.toml mirrors (per cosmos-audit guard #4) |
⏳ Follow-up cross-planet session |
Read next¶
- v1 shipped — what's in there + how it works — every shipping artefact and decision
- v2 roadmap — what's next + open ideas — pickup point for the next session
- Deploy playbook — how to deploy + redeploy + rollback
- Vision & creative brief — original creative brief (now mostly historical)
- Cosmos Philosophy — universal laws + atmosphere autonomy
- Cosmos Audit — single source of truth on every planet
- Voice & Tone — Sush's voice fingerprints
Provenance¶
Vision drafted 8 May 2026 NZST (session 2d6287c4-...). Three text-heavy mockups built and rejected by Sush — wrong category. Phase 0 + 1 + 2 + deploy shipped 8 May 2026 NZST (session bf8416ea-...). v1.1 polish shipped 8 May 2026 evening (session 061c101c-...) — Playwright screenshots diagnosed halo bleed, opaque lotus, and mobile clumping; transparent lotus + hover-pause + auto-list + tightened halos shipped in commit 98a5f27. Live commit history at github.com/susanthgit/cosmos-atlas/commits/main.