Přejít na hlavní obsah

B1App

B1App je veřejně dostupná aplikace pro členy církve, postavená na Next.js. Nabízí prostředí pro členy včetně profilů, adresářů skupin, živého přenosu a stránek pro dary.

Než začnete

varování

B1App vyžaduje Node.js 22 nebo novější. Starší verze nejsou podporovány.

Nastavení​

1. Klonování repozitáře​

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

2. Instalace závislostí​

cd B1App
npm install

3. Nastavení proměnných prostředí​

cp dotenv.sample.txt .env

Otevřete .env a nastavte adresy koncových bodů NEXT_PUBLIC_*_API. Mohou směřovat na sdílené demo API (https://api.demo.churchapps.org) nebo na vaši lokální instanci API. Ukázkový soubor může stále obsahovat vyřazené testovací adresy URL; nahraďte je.

4. Spuštění vývojového serveru​

npm run dev

Vývojový server Next.js se spustí na adrese http://localhost:3301.

Klíčové příkazy​

PříkazPopis
npm run devSpustí vývojový server Next.js na portu 3301
npm run buildProdukční sestavení pomocí Next.js
npm run testSpustí end-to-end testy pomocí Playwright
npm run lintSpustí lint pro Next.js

Klíčové proměnné prostředí​

ProměnnáPopis
NEXT_PUBLIC_*_APIAdresy koncových bodů API pro každý modul
info

Skript postinstall kopíruje soubory locale a CSS z @churchapps/apphelper. Pokud komponenty po instalaci vypadají bez stylů, spusťte npm run postinstall ručně.

Technologický zásobník​

  • Next.js 16 s TypeScriptem
  • React 19 pro komponenty uživatelského rozhraní
  • Material-UI 7 pro designový systém
  • React Query 5 pro stav na serveru
  • @churchapps/apphelper* balíčky pro sdílené komponenty

Nasazení​

Produkční sestavení se nasazují na S3 + CloudFront:

  1. npm run build vygeneruje optimalizované sestavení Next.js
  2. Výstup sestavení se synchronizuje do bucketu S3
  3. Spustí se invalidace CloudFront, aby se načetla nová verze
tip

Podrobné pokyny k nasazení najdete v průvodci Nasazení webových aplikací.