fluvie

Reconcile the marketing landing (the Astro site in web/site) with the repo: the package list and lesson gallery (data-driven via web/site/src/data/content.json + site.ts), the section copy and links, the design brief (web/site/website-structure.md), and gallery clips (web/site/public/media). Use after adding or changing an example/lesson, after a package is added/renamed/removed, after a canonical link or copy change, or after any change the public site at fluvie.dev should reflect.

Render a Fluvie scene at one or more frames and snapshot it deterministically via Alchemist (fixed fps, bundled fonts, fixed seed). Use to add or update golden-frame tests for any widget, animation, or effect.

Add a Fluvie animation preset as thin sugar over Animation.from/to/keyframes (never new animation logic), with an Alchemist golden. Use when adding a named preset like slideFade, pop, blurIn, kenBurns.

Scaffold a new Fluvie element widget consistently — file, public type, dartdoc, .animate() compatibility, Alchemist golden test (written first, red), barrel export, and lesson entry (extend the matching example/lib/lessons/NN_*.dart, or 12_the_kitchen_sink). Use when adding any widget under packages/fluvie/lib/src/elements/.

Scaffold a Fluvie service the house way — abstract contract, implementation, Riverpod provider, in-memory fake, and unit test. Use when adding any service/repository (media, encoding, capture, beat detection, snapshot, ...).