Введение

Этот стайлгайд описывает единые правила разработки фронтенд-проектов: код-стайл, архитектурные границы, типизацию, работу с сетью, состоянием, UI/UX производительность.

Цели

• Консистентность: одинаковые решения и подходы во всём коде, вне зависимости от автора.
• Предсказуемость: новые разработчики быстро понимают структуру проекта и правила работы.
• Качество и скорость: меньше багов и регрессий, быстрее ревью, проще поддержка и рефакторинг.
• Масштабируемость: правила подходят для small/medium/large проектов и командной разработки.

Данный стайлгад используется как общий стандарт команды: при разработке, ревью, онбординге и архитектурных обсуждениях.

Как применять

• Правила помечены уровнями MUST / SHOULD / MAY / FORBIDDEN.
• Если правило MUST нарушено — это считается дефектом и должно быть исправлено.
• Исключения возможны только с техническим обоснованием и должны быть задокументированы (обычно в README проекта).

Источник правды

При конфликте между "как привыкли" и тем, что написано здесь - приоритет у стайлгайда и "Технический регламент отдела разработки - Frontend". CI и автоматические проверки являются эталонным подтверждением корректности.