Next.js Template

Шаблон проекта на Next.js, построенный по стайлгайду.

Стек

Next.js 16 — фреймворк
React 19 / TypeScript 5 — UI и типизация
Mantine UI 8 — компоненты
Zustand 5 — глобальное состояние
SWR 2 — получение данных
PostCSS Modules — стили
Biome — линтер и форматтер
clsx — конкатенация CSS-классов

Архитектура

Проект использует SLM Design — модульную архитектуру с вертикальной организацией домена.

src/
├── app/            # Роутинг Next.js и точка входа приложения
├── layouts/        # Каркасы страниц (header, footer, sidebar)
├── screens/        # Контент конкретных страниц
├── widgets/        # Составные блоки интерфейса, не привязанные к домену
├── business/       # Бизнес-домены (auth, catalog, orders)
├── infra/ # Техсервисы (theme, i18n, API-адаптеры)
├── ui/             # UI-кит без бизнес-логики
└── shared/         # Общие ресурсы (утилиты, типы, стили, спрайты)

Зависимости идут строго сверху вниз: app → [layouts | screens] → widgets → business → infra → ui → shared.

Подробнее: Архитектура SLM.

Быстрый старт

npx tiged git@gromlab.ru:templates/nextjs.git my-app
cd my-app
npm install
npm run dev

Генерация кода

Модули создаются из шаблонов .templates/:

npx @gromlab/create module auth src/business
npx @gromlab/create widget header src/widgets
npx @gromlab/create layout admin src/layouts
npx @gromlab/create screen profile src/screens
npx @gromlab/create module button src/ui
npx @gromlab/create store auth src/shared

Скрипты

Команда	Описание
`npm run dev`	Запуск dev-сервера
`npm run build`	Сборка для продакшена
`npm run start`	Запуск продакшен-сервера
`npm run lint`	Проверка кода (Biome)
`npm run format`	Форматирование кода (Biome)
`npm run sprite`	Генерация SVG-спрайтов

2.6 KiB Raw Permalink Blame History Unescape Escape