PLAN.org

• Full-screen sky for your location and time: horizon, stars to about magnitude 6, constellation lines, planets, the moon at its true phase, the sun below the horizon as a glow at the edge.
• Pans with the device (compass and gyroscope) or by drag. Pinch to zoom.
• Tap any object for a card: name, magnitude, rise and set, distance, link to its Library page.
• Time scrubber: drag hours forward or back; tap to return to now.
• Alert chips across the top when relevant: aurora (Kp threshold for your latitude), ISS pass within the hour, launch within the hour, eclipse or conjunction today.

• Today sheet, pulled up from the bottom:

  • Moon: phase, illumination, next quarter.
  • Visible tonight: planets with direction, altitude, rise and set.
  • ISS passes over the next 3 days.
  • Next launch with countdown.
  • Space weather: Kp now and forecast.
  • Deep space: Voyager 1 distance and light time.

• Top-down orrery of the solar system for today. Log-scaled distances by default; toggle to true scale.
• Time slider from 1957 to 2050. Planets and spacecraft move together.
• Spacecraft drawn with their trajectories: Voyager 1 and 2, New Horizons, Juno, Europa Clipper, JUICE, Psyche, Parker Solar Probe, Lucy, and missions at Mars.
• Tap a planet or spacecraft for its Library page.
• Inset for Earth–Moon space: ISS, JWST at L2, lunar missions.

• Latest SDO full-disk image, full width. Swipe between wavelengths: 171 Å (corona), 304 Å (chromosphere), 193 Å, HMI visible light.
• Kp index: bar chart for the last 3 days and the 3-day forecast.
• Aurora oval for your hemisphere (OVATION model) with your location marked.
• Solar flares: GOES X-ray flux for the last 24 hours, flare classes marked.
• Plain-language summary in one line: "Quiet", "Minor storm likely tonight", and similar.

• Upcoming launches, each led by the rocket's silhouette drawn to a common scale.
• Detail: vehicle, mission, payload, orbit, pad on a map, countdown, launch window, webcast link.
• Live Activity from T−1 hour through orbit insertion.
• Past launches with outcome.

Every page leads with a drawing or image; facts follow as a spec sheet.

• Solar system: the sun, 8 planets, dwarf planets, major moons. Each has a dimensioned drawing, a to-scale comparison with Earth, a facts grid, the missions that visited on a timeline, and a short essay.
• Constellations: all 88. Modern line figure, the plate from a historical atlas (Bayer, Hevelius, Bode), bright stars, best season, where it is tonight.
• Stars: bright named stars with type, distance, colour and the origin of the name.
• Deep sky: the 110 Messier objects, then well-known NGC objects, with Hubble, Webb or ground images and a scale bar.
• Spacecraft and missions: active and historic. Status, location, instruments, findings, timeline.
• Later sections: exoplanets, rockets side by side to scale, the history of exploration as a browsable timeline, a scale view from Earth to the observable universe.

Search across all of it from the Library tab.

APNs requires HTTP/2. A Cloudflare engineer stated in workerd issue #4841 (2025-08-20) that production requests pass through Cloudflare's proxy, which upgrades them to HTTP/2; workerd itself, and so wrangler dev, does not support HTTP/2 and there are no plans to add it. Cloudflare's docs do not state this. Open-source senders rely on it (e.g. FiveSheepCo/cloudflare-apns2). Containers (Workers Paid) can run an HTTP/2 sender as a fallback. Spike: spikes/apns-worker.

• Sign the ES256 provider JWT with WebCrypto; reuse it for 20–60 minutes as Apple requires.
• Test pushes against a deployed staging Worker using the sandbox APNs host, never from local dev.
• Keep the sender behind the push Queue so it can move to Cloudflare Containers (a small Go or Python sender) if Workers' HTTP/2 stops working, without touching the rest.
• Delete tokens on HTTP 410.

The anonymous Launch Library 2 tier is 15 requests/hour; the 1-minute job needs a key. CelesTrak: never more than once per 2-hour update.

• devices: APNs token, environment (sandbox/production), 5° geomagnetic latitude band, UTC offset, preferences (aurora threshold, launch alerts, quiet hours), last seen.
• launches: normalized LL2 cache plus raw JSON.
• feed_snapshots: latest result per feed with fetch time and status.
• alerts_sent: dedupe key (type, band, storm event).
• live_activity_tokens: launch, update token, device; push-to-start tokens separately.
• spacecraft_ephemeris: spacecraft, date, position.
• content_versions: pack, version, hash, R2 key.

• Aurora: from Kp forecast and OVATION, find the latitude bands that can see aurora; notify devices in those bands where it is dark, outside quiet hours; at most one per band per storm.
• Launches: "launch in one hour" to opted-in devices; push-to-start the Live Activity (iOS 17.2+); update on countdown, hold, liftoff, staging, orbit or scrub; end 15 minutes after the outcome.

• Stored per device: push token, 5° latitude band, UTC offset, preferences. No location, no accounts.
• v1: per-IP rate limits. Later: App Attest verification in the Worker.

• Lives in server/ in this repo (a separate moonrise-server repo is optional); deploy with Wrangler.
• Staging and production Workers with separate D1 databases and APNs environments.
• Workers Logs for errors; feed staleness in /healthz.
• Likely Workers Paid plan (about $5/month) plus an optional Launch Library 2 key. Check current pricing for Queues and D1 before launch.

• Data sources: checked; see data sources. Open: Launch Library 2 commercial terms, OpenNGC ShareAlike, BSC5 licence statement.

• Packages/MoonriseKit:

  • CAstronomy: Astronomy Engine v2.1.19 C source.
  • SkyEngine: Swift wrapper. Tests against JPL Horizons (Chicago, 2026-10-17 02:00 UT): apparent RA/Dec and airless alt/az for the Moon, Mars, Jupiter, Saturn within 1′; heliocentric Jupiter and Saturn within 1′ angular (Saturn 0.00045 AU, about 10″).
  • SkyRenderer: stereographic projection, 8,404 stars to V 6.5, 88 constellations, planets to mag 6, moon with phase, horizon. Scene build 0.03 s, Canvas render of a 1179×2556 frame 0.09 s on an Apple silicon Mac via ImageRenderer. Not measured on a device; panning at 60 fps (16 ms per frame) is unproven and likely needs culling, pre-rendered star layers or Metal.
• spikes/apns-worker: ES256 provider token via WebCrypto (unit-tested), /push and a credential-free /probe. Deployed as moonrise-apns-spike; /probe got APNs JSON responses (403 InvalidProviderToken with an apns-id) on 3 of 3 calls, so the deployed Worker reaches the APNs sandbox over HTTP/2. Worker deleted after the test. A real push still needs an APNs key and a device token.
• Name reserved in App Store Connect; APNs key created (key ID 644XS4F2RG).

Stacked MRs: !2 app shell, !3 interaction, !4 Today sheet, !5 widgets, !6 device pointing.

Done and checked in the iOS 27 simulator: live sky with location, drag and pinch, object cards, time scrubber, night mode, Today sheet (moon, planets, sun, live SWPC Kp), sandbox APNs token.

Built but not checked:

• Widgets: build and embed; not viewed (simulator widget gallery could not be driven by automation).
• Device pointing: maths unit-tested; needs a real phone.

Not done:

• Draw time on a real iPhone (decides Canvas vs Metal).
• ISS passes: need an SGP4 propagator and CelesTrak data via the backend.
• Launches and Voyager in the Today sheet: backend (M2, M3).
• Automatic night mode after astronomical dusk.

Stacked MRs: !7 Sun tab, !8 backend, !9 aurora map.

• Sun tab: done, checked in the simulator with live data.
• Backend (server/): SWPC polling, /v1/today, device registration, aurora alert rules and APNs sending. Unit-tested; smoke-tested under wrangler dev with a local D1. Not deployed.
• Simplifications against the design above: aurora pushes are sent in-line from the cron (no Queue yet); "dark" is 20:00–04:00 local time rather than sun altitude; no rate limiting or App Attest on registration yet.
• Aurora map: OVATION probabilities on a polar map with Natural Earth coastlines; checked in the simulator.
• Not done: app registration with the backend (needs a deployed URL), launch caching, Live Activities.

MR !10.

• Backend: Launch Library 2 upcoming list every 10 minutes (separate cron, 6 of 15 anonymous requests per hour) into D1; GET /v1/launches. Smoke-tested locally with live LL2 data. LL2 images are not used (licence often "Unknown").
• App: Launches tab (list with T− countdowns, detail sheet); Debug builds read the API from http://localhost:8787 (MOONRISE_API_URL).
• Live Activity: "Follow on Lock Screen" starts a local countdown activity; verified on the simulator Lock Screen. Updates by push (holds, scrubs, liftoff) not done.
• Not done: rocket silhouettes to scale, push-to-start and push updates, "launch in one hour" notification.

MR !11.

• System tab: orrery with planets from Astronomy Engine (ecliptic axes), log radial scale beyond 1 AU, Voyager 1 and 2, Pioneer 10 and 11 and New Horizons paths from bundled JPL Horizons vectors (30-day steps to 2050), time slider 1958–2050 with play, distance and light-time table. Checked in the simulator.
• SkyEngine now holds one recursive lock around all Astronomy Engine calls, so any thread can use it.
• Not done: tap a planet or probe for its Library page, Earth–Moon inset, active missions (Juno, Europa Clipper, JUICE, Psyche, Parker, Lucy).

• Worker moonrise-server at https://moonrise-server.audit-labs.workers.dev, D1 moonrise, crons */5 (SWPC) and */10 (LL2), APNS_KEY set.
• SWPC polling confirmed in production (/v1/today serving Kp).
• LL2 from Cloudflare returned 429 on the first run: the anonymous limit is per IP and Workers share egress IPs. Needs an LL2 API key (LL2_API_KEY secret, supported). Launches stay empty until then.
• App Debug and Release builds use the deployed URL.
• The app does not register devices with the backend yet, so no aurora pushes are sent.

Sky, System, Sun, Launches, Library core (above).

• Events: eclipses, meteor showers, conjunctions, oppositions, each with an observing plan. Eclipse path maps with local timings; the 2 August 2027 total eclipse (Spain, North Africa, Egypt) is a launch target. Path maps and local timings done for every total and annular eclipse.
• Deep Space Network Now: which DSN dishes are talking to which spacecraft.
• More satellites: Tiangong, Hubble, Starlink trains, bright passes. Done: CelesTrak visual group plus one element set per Starlink launch still below about 400 km.
• Observing log stored as plain text or Org.
• Mars: latest rover raw images, local time at each rover.
• Library: exoplanets, rockets to scale, exploration timeline, scale view. Done.
• iPad, Mac, Apple Watch complications. Done: Mac as "Designed for iPad"; Watch app (Moon, Sun, planets tonight) with Moon and Planets complications.

• Sky cultures: Chinese, Polynesian, Arabic, Norse and other constellations over the same stars. Done for the ten CC BY-SA cultures in Stellarium's set; Arabic is not included (CC BY-ND, permission granted only to Stellarium).
• Historical sky for any date and place, with precession. Done: 3000 BCE to 3000 CE, with BSC5 proper motions and the pole star of the year.
• 3D planets from USGS maps; immersive sky and orrery on Vision Pro. Done: globes for the Sun, planets, dwarf planets and moons (NASA/USGS maps for 13, colour for the rest); visionOS app with globes, an orrery volume and an immersive star field. visionOS is compiled but not yet run (no simulator runtime installed).
• Guided seasonal sky tours and mission stories. Tours done: four, by months, 5 to 8 stops each, in Library/Resources/tours. Mission stories done for Voyager 1 and 2, Pioneer 10 and 11 and New Horizons, on the orrery.
• Live coverage of major events (e.g. an Artemis landing) on the orrery with a Live Activity. Done: GET /v1/live with a Horizons trajectory, an Earth–Moon map on the System tab and a Live Activity. Artemis I is configured as a past event for replay; add Artemis II and later missions to server/src/live.ts (Horizons ID, window, phases) once their Horizons IDs are published.
• Maybe: smart-telescope pointing (Seestar and similar).