Fakturaflyt

Architecture

How Fakturaflyt (https://fakturaflyt.pages.dev) is built, where its demo data lives, and how it ships.

Request path

1. Landing page and demo in one Vite SPA (React + React Router). There is no backend: every demo step runs in the browser.
2. The edge serves index.html and hashed assets; client routing takes over for /, /demo and the /* fallback (public/_redirects).
3. Demo EHF-XML is generated locally with the vendored ehf-helper copy and stays in the browser until downloaded. The only network call the app itself makes besides the configured lead-form POST is the optional Cloudflare Web Analytics beacon.

Data and state

• Demo invoices, customers and amounts are in-memory example data — nothing is sent and no accounting system is updated.
• Booking, contact, lead form and analytics are build-time constants (BOOKING_URL, CONTACT_URL, LEAD_ENDPOINT, ANALYTICS_TOKEN in src/vimplement.js), configured per docs/booking-setup.md. CONTACT_URL is the live VImplement request form; BOOKING_URL stays empty until a calendar is pasted. Every CTA resolves through src/lib/cta.js (booking -> contact -> mailto/tel) with UTM attribution per placement. Empty LEAD_ENDPOINT renders no form; set, it renders the 3-field native POST.
• The app itself keeps no server-side state: no database, no sessions.

Background work

• Daily live-revision check: .github/workflows/verify-live.yml runs on cron: "23 4 * * *" (tokenless) — it resolves master HEAD via git ls-remote and proves the edge still serves it with check_build_json.py --url.
• GitHub Actions validates every push to master (npm ci, build, Playwright smoke); Cloudflare Pages publishes project fakturaflyt from dist/.
• No backend, no queues, no other scheduled jobs.

Surfaces

Public URL	https://fakturaflyt.pages.dev
Source	github.com/bergvictor/fakturaflyt
Routes	/, /demo, /architecture.html (also /architecture), /ehf-sjekkliste.html; unknown paths serve /index.html with HTTP 200.
Deploy	Vite builds src/ to dist/; public/ is copied verbatim and deploys with project fakturaflyt.

Ship it

npm ci
npm run build
git push origin master
# wait for the Cloudflare Pages production build, then:
python3 scripts/check_build_json.py --url https://fakturaflyt.pages.dev --expected-revision <full-SHA>