diff --git a/docs/architecture.adoc b/docs/architecture.adoc
index 548633c..0dd2ca7 100644
--- a/docs/architecture.adoc
+++ b/docs/architecture.adoc
@@ -225,32 +225,50 @@ like a base map style's own small circular POI icons, blending in
instead of reading as "your data". A rounded square rather than a
pin/teardrop: it matches how the National Park Service itself frames
these exact category symbols (below) on its own maps, so the two look
-native together instead of like mismatched icon styles. It's colored
-via `["coalesce", ["get", "color"], TRACK_COLOR]` (falling back to the
-plain track color for a waypoint with no category, e.g. a hand-placed
-GNSS pin) and — unlike a pin, which has to anchor at its tip — centered
-directly on the coordinate with plain default anchoring, which also
-means the category-glyph layer on top needs no offset math: both
-layers just share the same center anchor at `[0, 0]`. A small curated
-icon set (`public/js/icons.js`'s `POI_ICONS`, covering the categories
-p4n2gpx actually uses, not an exhaustive OsmAnd icon set) draws a white
-glyph on top of the badge for any waypoint whose `icon` matches a known
-key (filtered out entirely for anything else, so an unrecognized icon
-key just falls back to a plain colored badge rather than a
-broken/missing image warning). Six of the seven glyphs are the
+native together instead of like mismatched icon styles. `_addLayers`
+defaults a point's `color` to the plain track color right on the
+feature (`feature.properties.color ||= TRACK_COLOR`) before it ever
+reaches a layer, rather than a `coalesce` in a style expression — see
+below for why. Unlike a pin, which has to anchor at its tip, the badge
+is centered directly on the coordinate with plain default anchoring,
+which also means the category-glyph layer on top needs no offset math:
+both layers just share the same center anchor at `[0, 0]`. A small
+curated icon set (`public/js/icons.js`'s `POI_ICONS`, covering the
+categories p4n2gpx actually uses, not an exhaustive OsmAnd icon set)
+draws a white glyph on top of the badge for any waypoint whose `icon`
+matches a known key (filtered out entirely for anything else, so an
+unrecognized icon key just falls back to a plain colored badge rather
+than a broken/missing image warning). Six of the seven glyphs are the
National Park Service's own map symbols
(`github.com/nationalparkservice/symbol-library`, BSD-licensed,
originally forked from Mapbox's Maki project) — a professional,
purpose-built icon set beats hand-drawing "fuel pump"/"picnic table"
glyphs from scratch; `forest` has no NPS equivalent (that set covers
-facilities, not land cover) and stays hand-drawn. Both the badge and
-the category glyphs are rasterized once per style load
-(`_registerPoiIcons`, an SVG → `
` → `