Hopp til hovedinnhold

B1App

B1App er den offentlige medlemsappen for menigheter, bygget med Next.js. Den gir medlemsopplevelsen, inkludert profiler, gruppekataloger, direktesending og givingssider.

Før du begynner

Advarsel

B1App krever Node.js 22 eller nyere. Tidligere versjoner støttes ikke.

Oppsett​

1. Klon repositoryet​

git clone https://github.com/ChurchApps/B1App.git

2. Installer avhengigheter​

cd B1App
npm install

3. Konfigurer miljøvariabler​

cp dotenv.sample.txt .env

Åpne .env og konfigurer URL-ene for NEXT_PUBLIC_*_API-endepunktene. Disse kan peke til det delte demo-API-et (https://api.demo.churchapps.org) eller din lokale API-instans. Eksempelfilen kan fortsatt liste utrangerte staging-URL-er; erstatt dem.

4. Start utviklingsserveren​

npm run dev

Next.js-utviklingsserveren starter på http://localhost:3301.

Viktige kommandoer​

KommandoBeskrivelse
npm run devStart Next.js-utviklingsserveren på port 3301
npm run buildProduksjonsbygg via Next.js
npm run testKjør ende-til-ende-tester med Playwright
npm run lintKjør Next.js-lint

Viktige miljøvariabler​

VariabelBeskrivelse
NEXT_PUBLIC_*_APIAPI-endepunkt-URL-er for hver modul
Info

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

Teknologistakk​

  • Next.js 16 med TypeScript
  • React 19 for UI-komponenter
  • Material-UI 7 som designsystem
  • React Query 5 for serverstatus
  • @churchapps/apphelper*-pakker for delte komponenter

Distribusjon​

Produksjonsbygg distribueres til S3 + CloudFront:

  1. npm run build lager det optimaliserte Next.js-bygget
  2. Byggutdataene synkroniseres til en S3-bøtte
  3. En CloudFront-invalidering utløses for å servere den nye versjonen
Tips

For detaljerte distribusjonsinstruksjoner, se veiledningen Distribusjon av webapper.