B1App
B1App -- публичное приложение для членов церкви, построенное на Next.js. Оно обеспечивает пользовательский опыт для членов, включая профили, справочники групп, прямые трансляции и страницы пожертвований.
Перед началом работы
- Установите Node.js 22+ и Git -- см. Предварительные требования
- Настройте цель API (staging или локальный) -- см. Переменные окружения
B1App требует Node.js 22 или новее. Более ранние версии не поддерживаются.
Настройка
1. Клонирование репозитория
git clone https://github.com/ChurchApps/B1App.git
2. Установка зависимостей
cd B1App
npm install
3. Настройка переменных окружения
cp dotenv.sample.txt .env
Откройте .env и настройте URL-адреса эндпоинтов NEXT_PUBLIC_*_API. Они могут указывать на staging API или на ваш локальный экземпляр API.
4. Запуск сервера разработки
npm run dev
Сервер разработки Next.js запускается по адресу http://localhost:3301.
Основные команды
| Команда | Описание |
|---|---|
npm run dev | Запуск сервера разработки Next.js на порту 3301 |
npm run build | Продакшен-сборка через Next.js |
npm run test | Запуск сквозных тестов с Playwright |
npm run lint | Запуск линтера Next.js |
Ключевые переменные окружения
| Переменная | Описание |
|---|---|
NEXT_PUBLIC_*_API | URL API-эндпоинтов для каждого модуля |
Скрипт postinstall копирует файлы локализации и CSS из @churchapps/apphelper. Если компоненты выглядят без стилей после установки, выполните npm run postinstall вручную.
Технологический стек
- Next.js 16 с TypeScript
- React 19 для UI-компонентов
- Material-UI 7 для дизайн-системы
- React Query 5 для управления серверным состоянием
- Пакеты
@churchapps/apphelper*для общих компонентов
Развёртывание
Продакшен-сборки развёртываются в S3 + CloudFront:
npm run buildгенерирует оптимизированную сборку Next.js- Вывод сборки синхронизируется с S3-бакетом
- Запускается инвалидация CloudFront для обслуживания новой версии
Подробные инструкции по развёртыванию см. в руководстве Развёртывание веб-приложений.