# Feature-Sliced Design


## documentation

- [Примеры](/examples.md): Список сайтов, сделанных людьми с FSD
- [🧭 Навигация](/nav.md): Feature-Sliced Design Navigation help page
- [Поиск по сайту](/search.md)
- [Версии Feature-Sliced Design](/versions.md): Feature-Sliced Design Versions page listing all documented site versions
- [💫 Community](/community.md): Community resources, additional materials
- [Team](/community/team.md): Core-team
- [Альтернативы](/docs/about/alternatives.md): История архитектурных подходов
- [Миссия](/docs/about/mission.md): Здесь описаны цели и ограничения применимости методологии, которыми мы руководствуемся при разработке методологии
- [Мотивация](/docs/about/motivation.md): Главная идея Feature-Sliced Design - облегчить и удешевить разработку комплексных и развивающихся проектов, на основании объединения результатов исследований, обсуждения опыта разного рода широкого круга разработчиков.
- [Продвижение в компании](/docs/about/promote/for-company.md): Нужна ли методология проекту и компании?
- [Продвижение в команде](/docs/about/promote/for-team.md): - Онбординг новых людей
- [Аспекты интеграции](/docs/about/promote/integration.md): Что получаем в конечном счете?
- [Частичное применение](/docs/about/promote/partial-application.md): Как частично применять методологию? Имеет ли смысл? Что если игнорировать?
- [Абстракции](/docs/about/understanding/abstractions.md): Закон дырявых абстракций
- [Об архитектуре](/docs/about/understanding/architecture.md): Проблемы
- [Типы знаний в проекте](/docs/about/understanding/knowledge-types.md): В любом проекте можно выделить следующие "типы знаний":
- [Нейминг](/docs/about/understanding/naming.md): У разных разработчиков различный опыт и контекст, что может привести к недопониманию в команде, когда одни и те же сущности называются по-разному. Например:
- [О понимании потребностей и о формулировке задач](/docs/about/understanding/needs-driven.md): — Не получается сформулировать цель, которую будет решать новая фича? А может проблема в том, что сама задача не сформулирована? **Смысл ещё и в том, чтобы методология помогла вытащить наружу проблемное определение задач и целей**
- [Сигналы архитектуры](/docs/about/understanding/signals.md): Если есть ограничение со стороны архитектуры - значит на то есть явные причины, и последствия, если их игнорировать
- [Рекомендации по брендингу](/docs/branding.md): Визуальная айдентика FSD основана на его ключевых концепциях: Layered, Sliced self-contained parts, Parts & Compose, Segmented.
- [Памятка по декомпозиции](/docs/get-started/cheatsheet.md): Используйте её как быстрый справочник, когда вы решаете, как разбить ваш интерфейс по слоям. Ниже также доступна PDF-версия, чтобы вы могли распечатать её и держать под подушкой.
- [FAQ](/docs/get-started/faq.md): Свой вопрос можно задать в Telegram-чате, Discord-сообществе и GitHub Discussions.
- [Обзор](/docs/get-started/overview.md): Feature-Sliced Design (FSD) — это архитектурная методология для проектирования фронтенд-приложений. Проще говоря, это набор правил и соглашений по организации кода. Главная цель этой методологии — сделать проект понятнее и стабильнее в условиях постоянно меняющихся бизнес-требований.
- [Туториал](/docs/get-started/tutorial.md): Часть 1. На бумаге
- [Обработка API-запросов](/docs/guides/examples/api-requests.md): handling-api-requests}
- [Авторизация](/docs/guides/examples/auth.md): В общих чертах авторизация состоит из следующих этапов:
- [Автокомплит](/docs/guides/examples/autocompleted.md): Про декомпозицию по слоям
- [Browser API](/docs/guides/examples/browser-api.md): Про работу с Browser API: localStorage, audioApi, bluetoothAPI и т.п.
- [CMS](/docs/guides/examples/cms.md): Фичи бывают разные
- [Обратная связь](/docs/guides/examples/feedback.md): Errors, Alerts, Notifications, ...
- [i18n](/docs/guides/examples/i18n.md): Куда положить? Как с этим работать?
- [Метрика](/docs/guides/examples/metric.md): Про способы инициализировать метрики в приложении
- [Монорепозитории](/docs/guides/examples/monorepo.md): Про применимость для монорепозиториев, про bff, про микроаппы
- [Лейауты страниц](/docs/guides/examples/page-layout.md): Это руководство рассматривает абстракцию лейаута страницы — когда несколько страниц имеют одинаковую структуру, отличаясь только основным содержимым.
- [Desktop/Touch платформы](/docs/guides/examples/platforms.md): Про применение методологии для desktop/touch
- [SSR](/docs/guides/examples/ssr.md): Про реализацию SSR с применением методологии
- [Темизация](/docs/guides/examples/theme.md): Куда положить работу с темой и палитрой?
- [Типы](/docs/guides/examples/types.md): В этом руководстве рассматриваются типы данных из типизированных языков, таких как TypeScript, и где они вписываются в FSD.
- [White Labels](/docs/guides/examples/white-labels.md): Figma, brand uikit, templates, адаптируемость к брендам
- [Кросс-импорты](/docs/guides/issues/cross-imports.md): Кросс-импорты появляются тогда, когда слой/абстракция начинает брать слишком много ответственности, чем должна. Именно поэтому методология выделяет новые слои, которые позволяют расцепить эти кросс-импорты
- [Десегментация](/docs/guides/issues/desegmented.md): Ситуация
- [Роутинг](/docs/guides/issues/routes.md): Ситуация
- [Миграция с кастомной архитектуры](/docs/guides/migration/from-custom.md): Это руководство описывает подход, который может быть полезен при миграции с кастомной самодельной архитектуры на Feature-Sliced Design.
- [Миграция с v1](/docs/guides/migration/from-v1.md): Зачем v2?
- [Миграция с v2.0 на v2.1](/docs/guides/migration/from-v2-0.md): Основным изменением в v2.1 является новая ментальная модель разложения интерфейса — сначала страницы.
- [Использование с Electron](/docs/guides/tech/with-electron.md): Electron-приложения имеют особую архитектуру, состоящую из нескольких процессов с разными ответственностями. Применение FSD в таком контексте требует адаптации структуры под специфику Electron.
- [Использование с Next.js](/docs/guides/tech/with-nextjs.md): FSD совместим с Next.js как в варианте App Router, так и в варианте Pages Router, если устранить главный конфликт — папки app и pages.
- [Использование с NuxtJS](/docs/guides/tech/with-nuxtjs.md): В NuxtJS проекте возможно реализовать FSD, однако возникают конфликты из-за различий между требованиями к структуре проекта NuxtJS и принципами FSD:
- [Использование с React Query](/docs/guides/tech/with-react-query.md): Проблема «куда положить ключи»
- [Использование с SvelteKit](/docs/guides/tech/with-sveltekit.md): В SvelteKit проекте возможно реализовать FSD, однако возникают конфликты из-за различий между требованиями к структуре проекта SvelteKit и принципами FSD:
- [Docs for LLMs](/docs/llms.md): This page provides links and guidance for LLM crawlers.
- [Слои](/docs/reference/layers.md): Слои - это первый уровень организационной иерархии в Feature-Sliced Design. Их цель - разделить код на основе того, сколько ответственности ему требуется и от скольких других модулей в приложении он зависит. Каждый слой несет особое семантическое значение, чтобы помочь вам определить, сколько ответственности следует выделить вашему коду.
- [Публичный API](/docs/reference/public-api.md): Публичный API — это контракт между группой модулей, например, слайсом, и кодом, который его использует. Он также действует как ворота, разрешая доступ только к определенным объектам и только через этот публичный API.
- [Слайсы и сегменты](/docs/reference/slices-segments.md): Слайсы
- [Feature-Sliced Design](/index.md): Architectural methodology for frontend projects