docs/nextjs-style-guide

Fork 0

Files

S.Gromov 36304c14f0

CI/CD Pipeline / docker (push) Failing after 38s

Details

CI/CD Pipeline / deploy (push) Has been skipped

Details

docs: обновить разделы на архитектуру SLM Design

- заменены все упоминания FSD на SLM Design в 10 файлах документации
- обновлены слои features/ и entities/ на business/, infrastructure/, ui/
- обновлены таблицы генерации кода и CLI-примеры
- обновлены примеры путей и деревья файлов (naming, project-structure)
- исправлен YAML frontmatter в architecture.md (двоеточие без кавычек)
- перегенерированы RULES.md и README

2026-04-20 10:40:52 +03:00

3.8 KiB

Raw Blame History

NextJS Style Guide

Правила и стандарты разработки на NextJS и TypeScript: архитектура, типизация, стили, компоненты, API и инфраструктурные разделы.

Для ассистентов

Полная документация в одном MD файле: https://gromlab.ru/docs/nextjs-style-guide/raw/branch/main/generated/ru/RULES.md

Структура документации

Workflow

Что делать и в каком порядке — пошаговые инструкции.

Раздел	Отвечает на вопрос
Начало работы	Что нужно знать перед началом разработки?
Создание проекта	Как начать новый проект?
Генерация кода	Какие модули должны генерироваться из шаблонов?
Добавление страницы	Как добавить новую страницу в проект?
Добавление UI-модуля	Как создать компонент, бизнес-модуль, виджет или layout?
Стилизация	Как стилизовать компоненты в проекте?
Получение данных	Как получать данные с сервера?
Управление состоянием	Как работать с состоянием?
Локализация	Как добавлять переводы и подключать локализацию?

Базовые правила

Каким должен быть код — стандарты, не привязанные к конкретной технологии.

Раздел	Отвечает на вопрос
Технологии и библиотеки	Какой стек используем?
Архитектура	Как устроены слои SLM, зависимости, публичный API?
Стиль кода	Как оформлять код: отступы, кавычки, импорты, early return?
Именование	Как называть файлы, переменные, компоненты, хуки?
Документирование	Как писать JSDoc: что документировать, а что нет?
Типизация	Как типизировать: type vs interface, any/unknown?

Прикладные разделы

Как это настроить и использовать — конфигурация, структура и примеры кода для конкретных областей.

Раздел	Отвечает на вопрос
Настройка VS Code	Как настроить редактор для проекта?
Структура проекта	Как организованы папки и файлы по SLM?
Компоненты	Как устроен компонент: файлы, пропсы, clsx?
Page-level компоненты	Как описывать layout, page, loading, error, not-found?
Шаблоны и генерация кода	Как работают шаблоны, синтаксис и инструменты генерации?
Стили	Как писать CSS: PostCSS Modules, вложенность, медиа, токены?
Изображения	(не заполнен)
SVG-спрайты	(не заполнен)
Видео	(не заполнен)
API	(не заполнен)
Stores	(не заполнен)
Хуки	(не заполнен)
Шрифты	(не заполнен)
Локализация	(не заполнен)

3.8 KiB Raw Blame History Unescape Escape