React + TypeScript + Vite SPA for Joulenap, wired to the backend REST API.
cd frontend
npm ci
npm run dev # Vite dev server on :5173, proxies /api -> http://localhost:8080Run the backend (cd backend && joulenap or uvicorn app.main:create_app --factory)
alongside it so the proxied API is available.
npm run build # type-checks (tsc --noEmit) then emits frontend/distThe FastAPI backend serves frontend/dist as static files, so a production image just
needs the built output present. dist/ is git-ignored.
src/api/— typed client + response types for/api/*src/auth/,src/config/— auth + config React contextssrc/pages/—Login,Dashboard(+dashboard/panels),Settings(+settings/panels, incl. the device editor)src/wizard/— the two device wizards (add a PVE, add a PBS) and the PBS steps they sharesrc/shell/— header + authenticated app shellsrc/components/,src/hooks/,src/utils/— shared widgets/helperssrc/i18n/—react-i18nextsetup;en.jsonis the base language,it.jsonthe translation
English is the source language. The active language follows app.language from the
backend config (the Localization settings panel changes it). Add a key to en.json
first, then mirror it in it.json.