Skip to content

Создание проекта из шаблона

Создание нового проекта на основе готового шаблона.

Что внутри

Шаблон — готовый скелет проекта с применёнными правилами стайлгайда:

  • Стек: Next.js (App Router), TypeScript, React.
  • Архитектура: структура папок по SLM, алиасы импортов.
  • Качество кода: Biome (линтер и форматер), настройки VS Code.
  • Стили: PostCSS Modules с плагинами, токены, медиа-брейкпоинты.
  • Ассеты: генерация SVG-спрайтов.
  • Кодогенерация: шаблоны для страниц, компонентов, хуков, сторов. в

Установка

  1. Склонировать шаблон в родительском каталоге будущего проекта:

    bash
    npx tiged git@gromlab.ru:templates/nextjs.git my-app

    tiged копирует снимок репозитория без истории git. Имя каталога (my-app) заменяется на нужное.

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

    bash
    cd my-app
    npm install
  3. Проверить сборку:

    bash
    npm run build

    Сборка должна завершиться без ошибок.

Правила

  • Шаблон — источник истины. Не добавлять, не удалять и не переименовывать файлы шаблона «для приведения к канону»: шаблон уже канонический. Любое несоответствие — баг шаблона, а не проекта.
  • Менеджер пакетов — npm. Отклонение (pnpm, yarn, bun) — только по явному решению с пониманием, что стайлгайд этого не предусматривает.
  • Не инициализировать git заново автоматически. tiged намеренно не создаёт .git/ — решение о репозитории принимает разработчик.