Files
nextjs-template/ai/nextjs-style-guide/creating-project/from-template.md
S.Gromov f2358da397 docs: добавить стайлгайд nextjs-style-guide в репозиторий
- Добавлена документация SLM-архитектуры, базовых правил и прикладных разделов
- Добавлены разделы: стили, SVG-спрайты, шаблоны генерации, PostCSS, REST, Realtime
- Удалены устаревшие файлы (спрайты, скрипты, стили из app/)
2026-04-30 19:32:10 +03:00

2.7 KiB
Raw Blame History

title, description, keywords
title description keywords
Создание проекта из шаблона Создание нового проекта на основе готового шаблона.
создать проект из шаблона
шаблон
template
tiged
degit
клонировать шаблон
эталонный шаблон
быстрый старт
scaffold
новый проект

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

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

Что внутри

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

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

Установка

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

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

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

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

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

    npm run build
    

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

Правила

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