Skip to main content

Context

The SO1 ecosystem documentation was consolidated from a flat “SO1 Platform” + “SO1 Apps” structure into three intuitive domains aligned with subdomains:
DomainSubdomainPurpose
Landingso1.ioFirst contact — getting started, Zoid Council skills
Missionmission.so1.ioOperational core — architecture, agents, runbooks
Roverrover.so1.ioTechnical interface — API reference, control plane

Decisions

SO1 Apps Removal

The “SO1 Apps” tab was removed from Atlas navigation. These were pre-built modules (FLASHY, Incident Responder, etc.) that added navigation complexity without clear user value at this stage. Content files remain in apps/so1/ for future use but are excluded from the active navigation tree.

Landing/Mission/Rover Split Rationale

The three-domain split maps to a natural user journey:
  1. Landing — “What is this?” — Introduction, concepts, the Zoid Council. This is what you read before you commit.
  2. Mission — “How does it work?” — Architecture decisions, agent deployment, operational runbooks. This is what you read when you’re building.
  3. Rover — “How do I connect?” — API contracts, authentication, rate limits. This is what you read when you’re integrating.

Mars Theme in Landing Page (flight.devarno.cloud)

The personal landing page at flight.devarno.cloud was already heavily space-themed (canvas stars, shooting stars, satellites). Mars elements were integrated as a progressive discovery — not forced from the start:
  • Warm-tinted stars: ~20% of stars in the lower 40% of the canvas have amber/iron-oxide hues
  • Mars horizon glow: Subtle gradient at canvas bottom
  • Amber shooting stars: 30% of meteors have warm trails
  • Scroll-driven atmosphere: A MarsAtmosphere overlay that increases warmth as users scroll deeper
  • Dust motes: Tiny amber particles that only appear after 50% scroll depth
The key design principle: Mars is something users notice through exploration, not something imposed upfront.

Atlas Mars Enhancement

  • Added surface grain texture (SVG noise filter at 1.5% opacity)
  • Added horizon glow pseudo-element at page bottom
  • Added sol-pulse animation for status indicators
  • Enhanced atmospheric gradients in body background

Technical Notes

  • Atlas uses Mintlify’s url property on tabs to link Landing/Mission/Rover tabs to their respective subdomains
  • The Mars atmosphere component uses requestAnimationFrame with scroll throttling to avoid layout thrashing
  • Star warmth is calculated based on vertical position (y/height ratio) to create a natural gradient from cold space to warm Mars
  • All Mars effects respect prefers-reduced-motion

Files Changed

devarno-cloud/atlas

  • docs.json — Restructured navigation (SO1 Platform → Landing + Mission + Rover, removed SO1 Apps)
  • mars.css — Added surface grain, horizon glow, sol-pulse animation
  • index.mdx — Updated hero cards to reflect Landing/Mission/Rover

devarno-cloud/landing

  • src/components/layout/space.tsx — Warm-tinted stars, amber shooting stars, Mars horizon glow
  • src/components/layout/mars-atmosphere.tsx — New scroll-driven atmosphere overlay
  • src/app/globals.css — Mars dust float keyframe animation
  • src/app/page.tsx — Integrated MarsAtmosphere component

so1-io/so1-console

  • platform-tools/so1-landing/src/lib/constants.ts — Updated BRAND with Landing/Mission/Rover URLs, updated HABITAT_CARDS
  • platform-tools/so1-landing/src/components/sections/habitat-cards.tsx — Cards now link to respective domains
  • platform-tools/so1-landing/src/components/footer.tsx — Added Landing/Mission/Rover/Field Manual links