Hopp til hovedinnhold

B1 Admin

B1Admin er administrasjonsdashbordet for kirken -- en React-enkeltsideapplikasjon bygget med Vite og Material-UI. Kirkens ansatte bruker det til å administrere personer, grupper, oppmøte, gaver, innhold og mer.

Før du begynner

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 det delte demo-API-et (https://api.demo.churchapps.org) eller din lokale API-instans. Eksempelfilen kan fortsatt liste utgåtte staging-URL-er; erstatt dem.

4. Start utviklingsserveren​

npm start

Dette starter Vite-utviklingsserveren. Appen er tilgjengelig i nettleseren din med hot module replacement aktivert.

Viktige miljøvariabler​

VariabelBeskrivelse
REACT_APP_STAGEMiljønavn (f.eks. demo som i eksempelfilen, prod eller selfhost)
PORTPort for utviklingsserveren (standard: 3101)
REACT_APP_*_APIAPI-endepunkt-URL-er for hver modul
Info

postinstall-skriptet kopierer språk- og CSS-filer fra @churchapps/apphelper. Hvis komponentene ser ustilte ut, kjør npm run postinstall manuelt.

Viktige kommandoer​

KommandoBeskrivelse
npm startStart Vite-utviklingsserveren
npm run buildProduksjonsbygg via Vite
npm run testKjør ende-til-ende-tester med Playwright
npm run lintKjør ESLint med automatisk retting

Teknologistakk​

  • React 19 med TypeScript
  • Vite for byggverktøy og utviklingsserver
  • Material-UI 7 for UI-komponenter
  • React Query 5 for serverstatus
  • @churchapps/apphelper*-pakker for delte komponenter

Distribusjon​

Produksjonsbygg distribueres til S3 + CloudFront:

  1. npm run build genererer statiske ressurser
  2. Ressursene synkroniseres til en S3-bøtte
  3. CloudFront-invalidering utløses for å servere den nye versjonen
Tips

For detaljerte distribusjonsinstruksjoner, se veiledningen Distribusjon av webapper.