VZOR-frontend

Модуль фронтенда для проекта VZOR

Особенности реализации

адаптивный интерфейс хорошо смотрится на разных типах экранов
можно использовать как мобильное приложение, благодаря технологии PWA
рендеринг веб-страниц на сервере
светлая и тёмная темы
авторизация пользователей
параметрический поиск
поддержка drag-n-drop
ручное редактирование метаданных
админ-панель

Стек

Bun — быстрая среда исполнения JavaScript
TypeScript — статически типизированный JavaScript
Next.js — фронтенд-фреймворк на основе React
Tailwind CSS — CSS-фреймворк
shadcn/ui — набор компонентов
ESLint — статический анализатор кода
Stylelint — анализатор стилей
Prettier — форматировщик кода
Docker — платформа для контейнеризации

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

[!WARNING] > Полноценная работа фронтенда возможна только в том случае, если оно запущено в контейнере базового репозитория.

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

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

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

docker build -t vzor-frontend .

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

docker run -d --name vzor-frontend-standalone -p 3000:3000 vzor-frontend

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

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

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

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

bun install

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

bun run build

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

bun run start

Модификация

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

bun run dev

Чтобы добавить в проект компонент из экосистемы shadcn/ui, выполните:

bun run add-component <компонент>

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