B1 Admin
B1Admin er kirkeadministrasjonsdashbordet -- en React enkeltsideapplikasjon bygget med Vite og Material-UI. Kirkeansatte bruker den til å administrere personer, grupper, oppmøte, gaver, innhold og mer.
Før du begynner
- Installer Node.js 22+ og Git -- se Forutsetninger
- Konfigurer API-målet ditt (staging eller lokalt) -- se Miljøvariabler
Oppsett
1. Klon repositoriet
git clone https://github.com/ChurchApps/B1Admin.git
2. Installer avhengigheter
cd B1Admin
npm install
3. Konfigurer miljøvariabler
cp dotenv.sample.txt .env
Åpne .env og konfigurer API-endepunktene. Du kan peke dem mot enten staging-API-et eller din lokale API-instans.
4. Start utviklingsserveren
npm start
Dette starter Vite-utviklingsserveren. Appen vil være tilgjengelig i nettleseren din med automatisk modulerstatning aktivert.
Viktige miljøvariabler
| Variabel | Beskrivelse |
|---|---|
REACT_APP_STAGE | Miljønavn (f.eks. local, staging, prod) |
PORT | Utviklingsserverport (standard: 3101) |
REACT_APP_*_API | API-endepunkt-URL-er for hver modul |
Info
postinstall-skriptet kopierer lokaliserings- og CSS-filer fra @churchapps/apphelper. Hvis komponenter ser ut til å mangle stiler, kjør npm run postinstall manuelt.
Viktige kommandoer
| Kommando | Beskrivelse |
|---|---|
npm start | Start Vite-utviklingsserver |
npm run build | Produksjonsbygging via Vite |
npm run test | Kjør ende-til-ende-tester med Playwright |
npm run lint | Kjør ESLint med automatisk retting |
Teknologistabel
- React 19 med TypeScript
- Vite for byggeverktøy og utviklingsserver
- Material-UI 7 for UI-komponenter
- React Query 5 for serverstatus
@churchapps/apphelper*-pakker for delte komponenter
Distribusjon
Produksjonsbygginger distribueres til S3 + CloudFront:
npm run buildgenererer statiske ressurser- Ressursene synkroniseres til en S3-bøtte
- CloudFront-invalidering utløses for å levere den nye versjonen
Tips
For detaljerte distribusjonsinstruksjoner, se guiden for Webappdistribusjon.