The previous styles.css was a from-memory reconstruction with wrong
palette (tan paper #f4ede0 vs the live near-white #fcfcfb, red accent
vs warm-grey). HTML class names also diverged (.collage vs .gcollage,
#atlasList vs #atlasGrid, .stats-tl vs .stats-timeline). Result: the
overlay looked nothing like the live site.
Now:
- styles.css copied verbatim from the apt.ts <style> block (1449 lines)
- index.html mirrors the live body structure: header.top + main.stage
with view sections id=v0/v1/v2, nav.slider, about-modal
- apt.js updated for matching IDs/classes:
- View switching via translateX on .views container (live uses
flex: 0 0 100% per view, slides between them)
- Hover state via alpha-mask hit-testing in mousemove (.gtile is
pointer-events:none, bounding rects overlap)
- Atlas builds .bird-card elements (the live CSS class)
- atlasSort data-sort='alpha' (was 'first')
- #atlasGrid (was #atlasList)
Verified against Docker container faithfully replicating BirdNET-Pi's
runtime (Caddy + PHP-FPM as caddy user + php-fpm-socket-helper):
side-by-side screenshots with bird.onethreenine.net show identical
palette, typography, pill chrome, tile rendering. Differences are
content-only (different seeded species).
Blockers
- http://birdnet.local/avian/ now serves the collage (added avian/index.html
redirect to frontend/; previously the symlink target had no top-level
index, so users saw a directory listing of api/ assets/ forwarding/
frontend/ scripts/).
- Gemini model bumped from gemini-2.5-flash-image-preview (deprecated
2026-01-15) to the stable gemini-2.5-flash-image. Pregen was non-
functional out of the box.
- avian-mqtt.service: dropped %h (which expands to /root for system-mode
units regardless of User=). Use WorkingDirectory=~ which DOES respect
User=, plus a relative ExecStart.
- birdnet-api.php case 'lifelist' now aliases COUNT(*) AS n (was 'total'),
matching what apt.js reads for atlas card counts. Atlas previously
always displayed 0.
Bugs
- Retry-After parsing handles HTTP-date format without crashing.
- apt.js no longer fetches firstseen/timeseries (declared in state but
never consumed). Two wasted round-trips per page load removed.
- update_birdnet.sh defaults branch=avian-visitors so the (opt-in)
Sunday auto-update cron doesn't reset HEAD to upstream main and
delete the avian/ overlay.
- recording.php: removed dead $BIRDS_JSON_CANDIDATES.
Polish
- Pregen --sleep default raised 4→6s (more headroom under free-tier RPM).
- en-dash in README BOM (~$35–80) replaced with hyphen for style match.
- Slop sweep across user-facing docs: no em-dashes, no en-dashes, no
AI-slop word hits (robust/comprehensive/seamless/etc.).