Digital Garden

The Sun and the Terminator: the Visitor's Clock Is the Data Source

2026-09-17 · ~3 min read · frontend · design · essay

Prologue: the moon was real — and then?

Every celestial element on this site has hung on the word “real”: a true moon shaded by its actual phase, meteor showers radiating from their real calendar, the ISS crossing on its real orbit.

But this sky was missing two things — no sun in the daytime, no day and night on the world map.

This update completes them, in a surprisingly quiet way: zero requests. The sun’s position isn’t on a server. It’s in the visitor’s own clock.

The sun: a disc that rises and sets by local time

Top-right of the hero, a warm golden disc. Present in daytime, swelling into a larger, redder horizon sun at sunrise and sunset, fading out at night — not hidden, simply not supposed to be there.

Underneath is a J2000-epoch solar position approximation: mean longitude, the equation of center, obliquity, hour angle — one pipeline producing altitude and azimuth. Measured against reality: Wuhan at solar noon reads 81° at summer solstice and 36° at winter solstice, within a single degree. The disc climbs from horizon to zenith with altitude, tinting amber near the terminator — the color of atmospheric scattering, rendered this time as light.

Hover the disc and a status card surfaces: how many degrees up, how long until sunrise or sunset. What time the sun sets where you are — this site knows.

The terminator: a world map that never stops moving

The visitor star map used to hold only country dots. Now it carries a line — a bright golden terminator, drawn across the dots at the sun’s true position, with land dots in the night hemisphere dimmed.

The same math pipeline: subsolar latitude and longitude, sunset hour angle, polar day and night breaking the line where it should break. Open this site late at night in China and the terminator hangs between Europe and Africa, the Americas sunk in shadow. This map isn’t drawn. It’s computed — recomputed every second.

One computation, two celestial displays

The sun and the terminator share the same local-time math. Not laziness — architecture. Celestial mechanics shouldn’t compute themselves twice: the sun shines on Earth, the terminator splits day from night; they are two projections of the same fact.

Zero requests is the most extravagant part of this design. The ISS needs polling, aurora needs data feeds — the sun needs nothing. The visitor’s clock is the data source. Local computation within a degree, no network latency, no third-party API that can die. The most reliable data source is the watch that’s been ticking in your pocket all along.

Takeaways

A sense of the real isn’t piled on — it grows out of the right coordinate system. Moon, meteor showers, ISS, sun, terminator: each answers the same question. What does the actual sky look like, right now?

The next sky is aurora.

Comments

← Digital Garden