Example apps

Fluvie ships a set of small, kitten-themed example apps under examples/. Each one exercises a different way to turn a Fluvie composition into a real MP4: the encoder backends, the server, and the in-process render. They share one cohesive look through the examples/kitten_kit package (theme, sample media, and reusable composition builders), so each app stays tiny.

These are apps that host a render, so each keeps a composition registry and a committed capture harness. That is not the shape of a project you write. If you just want a video, you need no app at all: fluvie init scaffolds a composition file, fluvie preview ./lib/my_video.dart runs it live, and fluvie render ./lib/my_video.dart --out out.mp4 writes the file. See Start a project.

App	What it shows	Renders with
`gallery`	The thirteen lessons and the scrubbable inspector	CLI (desktop) and the server (web)
`cli_quickstart`	Install the CLI and render from the terminal	`fluvie_cli`
`desktop_studio`	A Linux desktop studio that renders to a file	`fluvie_cli`, in-process
`mobile_purrfect`	An Android app that renders on the phone	`fluvie_mobile_encoder`
`web_browser_studio`	A meme maker that renders in the browser	`fluvie_web_encoder` (ffmpeg.wasm)
`web_server_studio`	A promo studio that renders on a server	`fluvie_server`

Run the CLI quickstart

A tiny project with one composition and a capture harness. Render it with the CLI and you get an MP4.

cd examples/cli_quickstart
dart run fluvie_cli:fluvie render whisker_standup --out build/whisker.mp4

Run the desktop studio (Linux)

Pick a template, then render it to a file. The app shells out to the CLI.

cd examples/desktop_studio
flutter run -d linux

Run the mobile app (Android)

Name your cat, optionally add a photo, and render a birthday card on the device. Nothing leaves the phone.

cd examples/mobile_purrfect
flutter run -d android

Run the in-browser meme maker

Renders fully in the browser with ffmpeg.wasm, no backend. Vendor the wasm core once, then run.

cd examples/web_browser_studio
bash tool/fetch_ffmpeg.sh
flutter run -d chrome

Run the server-render studio

Customize a promo and render it on a Fluvie render server. Point it at a running server (see Rendering on a server).

cd examples/web_server_studio
flutter run -d chrome --dart-define=FLUVIE_API_URL=http://localhost:8080

Run the gallery

The thirteen lessons plus the inspector. Run it from the repo root so its render button can find the CLI.

cd examples/gallery
flutter run

How they are tested

Each app is verified end to end in CI: the build compiles, unit tests cover the view-models and services, and a real render produces an MP4 that is probed for a valid video stream. The web apps print a FLUVIE_E2E_RESULT marker the headless harness reads; the desktop and mobile apps assert the written file. See Testing.

Where to next

Your first video: write a composition from scratch.
On-device mobile rendering and in the browser.
Rendering on a server: stand up the render API the server studio calls.