The CodeForFire website, home of both apps:
Lagebuch (offline incident
documentation for the command vehicle, at /lagebuch/) and
FwAssist (small offline helpers for
the phone, at /fwassist/). The landing page at / presents both equally.
Built with
Astro Starlight, deployed to GitHub Pages at
https://codeforfire.github.io/.
The site content is German, because its readers are German fire brigades. This README and the code comments are English, matching the split used in the app repository.
Most pages are written here, in src/content/docs/. Some content is owned by
the app repositories and copied in at build time by scripts/sync-docs.mjs:
| On this site | Source |
|---|---|
lagebuch/datenschutz |
CodeForFire/lagebuch docs/datenschutz-und-sicherheit.md |
| Lagebuch logo, favicon, og:image | CodeForFire/lagebuch docs/logo/ |
| demo animation | CodeForFire/lagebuch docs/demo/einsatz-flow.gif |
screenshots on lagebuch/rundgang |
CodeForFire/lagebuch docs/screenshots/ |
| FwAssist icon | CodeForFire/FwAssist docs/play/icon-512.png |
screenshots on fwassist |
CodeForFire/FwAssist docs/screenshots/ |
Lagebuch used to live at the root; astro.config.mjs redirects the old
addresses (/download/, /rundgang/, …) to /lagebuch/….
The hotspot positions on rundgang (src/data/rundgang.ts) are percentages
of the 1920×1032 frame make screenshots renders. The build fails if a
screenshot is missing or changes size, and warns about a new screenshot that is
not part of the tour yet. After a visual change in the app, re-check the
positions with npm run dev.
Everything the script writes is gitignored — never edit those files here, edit them in the app repositories. The script fails the build if a source file has moved, rather than quietly dropping a page.
Because an automatic cross-repo trigger would need a token with write access to
this repository, the site rebuilds nightly (and on demand via Actions →
Pages → Run workflow). A change to the Datenschutz page or a fresh
make screenshots in either app therefore appears here within a day.
Needs Node 22.19 or newer (see .nvmrc) and checkouts of
CodeForFire/lagebuch and CodeForFire/FwAssist. The sync script looks for
each in $LAGEBUCH_PATH / $FWASSIST_PATH, then .lagebuch/ / .FwAssist/,
../<name> and ../../<name>.
npm install
npm run dev # syncs, then serves on http://localhost:4321/
npm run build # syncs, then builds into dist/
npm run preview # serve the built sitenpm run sync on its own refreshes the imported content. It prints the commit
it read from, so a stale checkout is visible rather than silently shipped.
Issues and pull requests are welcome. Community guidelines, the code of conduct and the security policy live in the CodeForFire org defaults.
Commits must be DCO signed off
(git commit -s) and cryptographically signed (git commit -S); main
rejects anything else.