diff --git a/README.md b/README.md
index 775a6ff..ad06278 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,10 @@ real astronomical data instead of fictional systems. Browse the solar neighbourh
star's system to see its planets on their real orbits, and drill into a single body for the
NASA figures behind it.
+**Live at **, published from `main` by
+[`.github/workflows/pages.yml`](.github/workflows/pages.yml). There is no backend — the whole
+thing is static files and a few megabytes of baked catalogue.
+
The source of a small Claude Code plugin also lives here — see [Plugins](#plugins) below.
@@ -74,6 +78,20 @@ around it. Mercury's, three pixels wide at that range, does not survive either w
with real photography where NASA/ESA/USGS imagery exists, and a surface derived from the body's
own measurements where it does not. See "On surfaces that were never photographed" below.
+**Object card** — hovering a body in the system view raises its figures over the live scene and
+clicking pins them, so two planets can be compared without flying out and back; **Full view**
+opens the detail route when the close-up is wanted. The card and the detail panel are built from
+one shared view model and one shared set of readouts, which is what stops the same planet reading
+255 K in one and 254 K in the other.
+
+**Measured against derived** — every figure is filed under the heading it earns. A published
+radius is measured; an equilibrium temperature computed from the host star's luminosity is
+derived, and says so. Orbital period is shown where it can honestly be had: for a heliocentric
+orbit it follows exactly from the semi-major axis, because in these units the Sun's mass *is* the
+unit of mass — Mars comes back 687.0 d against a published 686.98. It is deliberately absent for
+moons, whose elements are relative to a parent planet the catalogue carries no mass for, and for
+exoplanets, where assuming a solar-mass host would mis-state every planet around an M dwarf.
+
**Search** — name search across stars, solar-system bodies and exoplanets, navigating to the
same place an in-scene click would.
@@ -281,9 +299,12 @@ src/app/
Milky Way structure
shared/models/ record contracts shared by the app and the ETL
shared/rendering/ skybox, glow sprites, texture catalog
+ shared/format/ one formatter per physical quantity, precision following magnitude
shared/state/ navigation store (Angular signals)
tools/etl/ build-time data pipeline
e2e/ Playwright end-to-end tests
+public/ files served at the site root (favicon, link-preview image)
+.github/workflows/ CI, the Pages deploy, and an automated review pass
```
The design document behind all of this is `.junie/plans/nasa-star-map.md`.
diff --git a/public/social-preview.jpg b/public/social-preview.jpg
new file mode 100644
index 0000000..9c47e6b
Binary files /dev/null and b/public/social-preview.jpg differ
diff --git a/src/index.html b/src/index.html
index d70b2e4..5623c17 100644
--- a/src/index.html
+++ b/src/index.html
@@ -2,10 +2,26 @@
- Star Map
+ Star Map — the real solar neighbourhood in 3D
+
+
+
+
+
+
+
+
+
+
+
+
+
+