AppHelper

Пакеты @churchapps/apphelper* предоставляют общие React-компоненты и утилиты для всех веб-приложений ChurchApps. AppHelper структурирован как рабочее пространство монорепозитория, содержащее шесть пакетов, охватывающих основные компоненты, аутентификацию, пожертвования, формы, markdown и функциональность сайта/CMS.

Перед началом работы

• Установите Node.js и Git -- см. Предварительные требования
• Ознакомьтесь с процессом работы npm link для локальной разработки

Пакеты

Пакет	Описание
@churchapps/apphelper	Основные компоненты и утилиты
@churchapps/apphelper-login	UI входа и регистрации
@churchapps/apphelper-donations	Компоненты пожертвований
@churchapps/apphelper-forms	Компоненты конструктора форм
@churchapps/apphelper-markdown	Редактор и рендерер markdown
@churchapps/apphelper-website	Компоненты сайта и CMS

Настройка для локальной разработки

1. Клонируйте репозиторий:

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

2. Установите зависимости:

   cd AppHelper && npm install

3. Соберите все пакеты и запустите площадку Vite:

   npm run playground:reload

   Это собирает каждый пакет в рабочем пространстве, затем запускает сервер разработки площадки по адресу http://localhost:3001.

Совет

Площадка -- самый быстрый способ разработки и тестирования компонентов AppHelper. Она обеспечивает горячую перезагрузку сервера разработки Vite, позволяя видеть изменения в реальном времени.

Публикация

Публикация одного пакета:

npm run publish:apphelper

Публикация всех пакетов:

npm run publish:all

Предупреждение

При публикации обязательно обновите номер версии в соответствующем файле(ах) package.json перед запуском команды публикации. Все пакеты, зависящие от изменённого пакета, также должны быть обновлены.

Связанные статьи

• Helpers -- Базовый пакет утилит, используемый вместе с AppHelper
• Веб-приложения -- Веб-приложения, потребляющие эти пакеты
• Обзор общих библиотек -- Процесс работы npm link и обзор пакетов