Sakura-web

Веб-приложение для проекта Sakura

Стек

• Bun — быстрая среда исполнения JavaScript
• TypeScript — статически типизированный JavaScript
• Next.js — фронтенд-фреймворк на основе React
• Tailwind CSS — CSS-фреймворк
• HeroUI — набор компонентов
• Prisma ORM — ORM для работы с БД
• Auth.js — авторизация и управление сессиями
• ESLint — статический анализатор кода
• Stylelint — анализатор стилей
• Prettier — форматировщик кода
• Docker — платформа для контейнеризации

Установка и запуск

Warning

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

0. Клонируйте репозиторий и перейдите в его папку.

Посредством Docker

1. Установите Docker.
2. Поднимите базу данных PostgreSQL:

docker compose up -d

3. Создайте файл .env на основе .env.template и настройте все описанные там параметры.
4. Запустите сборку образа:

docker build -t sakura-web .

4. Теперь запускать образ можно командой:

docker run -d --name sakura-web-standalone -p 3000:3000 sakura-web

Без использования Docker

1. Установите Bun одним из способов. Например, для Windows:

powershell -c "irm bun.sh/install.ps1 | iex"

2. Поднимите базу данных PostgreSQL.

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

bun install

4. Создайте файл .env на основе .env.template и настройте все описанные там параметры.

5. Соберите проект:

bun run build

6. Теперь запускать проект можно командой:

bun run start

Модификация

Запуск сервера в режиме отладки осуществляется командой:

bun run dev

Запуск Prisma Studio выполняется командой:

bun run db:studio

Применение изменений к базе данных выполняется командой:

bun run db:push

Заполнение базы данных первоначальными значениями выполняется командой:

bun run db:seed

Прочие скрипты, необходимые для запуска линтеров, форматировщика и т. д. находятся в файле package.json.