Nyx · Moon Tracker

Purpose#

Lunar phase tracker — current phase, a monthly phase calendar, eclipse listings, and a detail tab with ephemeris readings. Wired via apps/oshun/web/src/app/domains/nyx/moon/page.tsx ('use client') which mounts <NyxMoonTracker onClose={() => router.back()} />.

Entry points#

• Direct URL / bookmark — yes (signed-in)
• In-app navigation — verify Nyx hub link and any "Moon · 84%" chip from the Nyx hub or events
• Browser back affordance — in-component back button calls router.back()

Layout regions#

NyxMoonTracker (apps/oshun/web/src/components/domains/nyx/NyxMoonTracker.tsx):

• Header: back button (aria-label="Go back"), title <h1>Moon Tracker</h1>
• Tab bar: four tabs from TABS — Current Phase, Calendar, Eclipses, Details
• Per-tab content:
  • current — phase illustration + current illumination data
  • calendar — month grid with previous/next month buttons (visible DAY_NAMES = Sun, Mon, Tue, Wed, Thu, Fri, Sat)
  • eclipses — list of upcoming solar and lunar eclipses
  • details — additional ephemeris (distance, libration etc.)

States#

• Loading — bundled data; client-only
• Default tab — Current Phase (verify initial tab state)
• Calendar populated — current month shown with phase icons per day
• Previous / Next month — month switches; verify date arithmetic crosses year boundary correctly
• Eclipses populated — list of upcoming eclipses
• Eclipses empty — verify empty-state copy
• Offline — static bundle; works offline

Interactions#

Header#

• "Go back" button (icon, ArrowLeft) — calls onClose → router.back()

Tab bar#

• Current Phase tab — sets tab='current'
• Calendar tab — sets tab='calendar'
• Eclipses tab — sets tab='eclipses'
• Details tab — sets tab='details'

Calendar tab#

• Previous month button — onPrevMonth shifts the month backward
• Next month button — onNextMonth shifts the month forward
• Day cell — verify whether tapping a day surfaces details or is decorative

Eclipses tab#

• Each eclipse row — verify whether row is interactive (link to a detailed view) or read-only

Data & contracts#

• Reads: bundled ephemeris / phase / eclipse data inside the component
• Writes: none
• Realtime: none
• Caching: static client bundle
• Auth/role check: middleware enforces signed-in for /domains/*

Cross-references#

• Domain hub: nyx.md — "Moon · 84%" appears in the hub chart
• Sibling tools: domains-nyx-solar.md, domains-nyx-solar-system.md
• Dashboard widget: domains-nyx-widgets.md (Moon Phase widget mirrors current phase)
• Component source: apps/oshun/web/src/components/domains/nyx/NyxMoonTracker.tsx

Open questions / known gaps#

• Confirm whether the calendar respects per-user observer lat/lng for rise/set
• Verify whether day cells are interactive (the icon usage suggests buttons, but the snippet doesn't show a handler)
• Confirm units shown in Details tab (km vs au for distance, deg for libration)