S.Gromov
bdb99ade62
- перенесены каноны и VitePress-конфиги в projects/<slug> - добавлены корневой и проектные build.ts для сборки артефактов - добавлены shared-библиотеки сборки в projects/_shared/lib - обновлены CI, Dockerfile, package.json, gitignore и README - удалена сборка frontend-агента
52 lines
2.7 KiB
Markdown
52 lines
2.7 KiB
Markdown
---
|
||
title: Создание проекта из шаблона
|
||
description: Создание нового проекта на основе готового шаблона.
|
||
keywords: [создать проект из шаблона, шаблон, template, tiged, degit, клонировать шаблон, эталонный шаблон, быстрый старт, scaffold, новый проект]
|
||
---
|
||
|
||
# Создание проекта из шаблона
|
||
|
||
Создание нового проекта на основе готового шаблона.
|
||
|
||
## Что внутри
|
||
|
||
Шаблон — готовый скелет проекта с применёнными правилами стайлгайда:
|
||
|
||
- **Стек:** 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/` — решение о репозитории принимает разработчик.
|