Самостоятельное развёртывание

Веб-приложения разработано так, чтобы его было легко модифицировать и развернуть на собственном сервере.

Запуск бэкенда и фронтенда на собственном сервере

На сервере должны быть установлены Git и Docker.

sudo apt install git # установка Git

Инструкция по установке Docker доступна здесь.

Сначала нужно клонировать репозиторий с проектом на сервер и войти в появившуюся папку:

git clone https://github.com/ksvfs/flashcards.git
cd flashcards

После этого нужно создать файл .env и заполнить его в соответствии с файлом .env.example.

После этого проект можно запускать:

docker compose up

Будут автоматически запущены пять сервисов, указанных в compose.yaml: база данных, бэкенд, веб-сервер, фронтенд и документация. SSL-сертификат будет получен и продлён автоматически.

Отдельный запуск фронтенда

Веб-приложение может работать и без серверной части. Можно просто сгенерировать статичные файла и закинуть их на хостинг или отдавать с помощью nginx.

Генерация статичных файлов фронтенда:

cd frontend
curl -fsSL https://bun.sh/install | bash # установка Bun для сборки приложения
# выполнить команды, которые предложить установщик Bun
bun run build # генерация статичных файлов

Статичные файлы будут сохранены в папку dist.