# feature-sliced/documentation

Architectural methodology for frontend projects

Repository: https://github.com/feature-sliced/documentation
Canonical: https://ross.abutalabs.com/products/feature-sliced-documentation
Homepage: https://fsd.how
Language: MDX
License: MIT
License Family: permissive
Topics: architecture, domain-driven, separation-of-concerns, vertical-slices, frontend-architecture, frontend, feature-sliced, high-cohesion, low-coupling
Last push: 2026-08-19T09:53:17+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 8, longevity 100
- inputs: {"age_days": 2061, "days_push": 14, "days_rel": 658, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2353, forks 224 (observed 2026-08-28T04:06:40.492941+00:00)

## What it is
Feature-Sliced Design (FSD) is an architectural methodology for organizing frontend application code into layers, slices, and segments, documented as a comprehensive specification and guide site. It is stack-agnostic and includes tooling such as the Steiger architecture linter, CLI folder generators, and LLM-friendly docs (llms.txt, agent skills).

## Use cases
- structure a large frontend codebase with clear layers and boundaries
- migrate an existing custom frontend architecture to a standardized methodology
- prevent cross-imports and enforce module boundaries in a React/Vue app
- onboard new developers to a frontend project with a uniform folder structure
- automatically lint project structure against FSD rules with Steiger
- provide FSD conventions to AI coding agents via llms.txt and skills

## When to choose
- you are building a frontend application (not a library) that has grown hard to maintain
- your team struggles with tangled imports and unclear module ownership
- you want a stack-agnostic, community-standardized architecture with active documentation
- you expect team growth and need a structure newcomers can quickly understand

## When to avoid
- you are building a reusable library or component package rather than an application
- your current architecture works well and the team is small and comfortable
- you need a strict, enforced framework rather than a set of conventions you must apply yourself

## Facets
- artifact type: learning-resource
- maturity: active
- function: documentation, developer-tools
- domain: frontend, web-development, developer-tools, tutorials
- platform: cross-platform
- tags: frontend-architecture, feature-sliced-design, methodology, vertical-slices, separation-of-concerns, code-organization, steiger, llms-txt, architecture, web-server

## Member repositories
- feature-sliced/documentation (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:40.492941+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:36:29.580358+00:00, confidence not recorded.
  - readme: https://github.com/feature-sliced/documentation (fetched 2026-08-28T04:06:40.492941+00:00, sha 1430fcff0cb2)
  - homepage: https://fsd.how (fetched 2026-08-29T10:17:36.955238+00:00, sha edd96746b4e3)
  - site_page: https://fsd.how/docs/get-started/overview (fetched 2026-08-29T10:17:36.957541+00:00, sha 5cc9d5b1d4e7)
  - site_page: https://fsd.how/docs/llms (fetched 2026-08-29T10:17:36.959529+00:00, sha 8e391b205afc)
  - site_page: https://fsd.how/docs/reference/layers (fetched 2026-08-29T10:17:36.961281+00:00, sha 74014036a4ea)
  - site_page: https://fsd.how/docs/guides/migration/from-custom (fetched 2026-08-29T10:17:36.963168+00:00, sha 5e9e24da5574)
  - site_page: https://fsd.how/docs/reference/public-api (fetched 2026-08-29T10:17:36.964742+00:00, sha ab1fbfc58024)
  - site_page: https://fsd.how/docs/guides/issues/cross-imports (fetched 2026-08-29T10:17:36.966644+00:00, sha 7ba25bf76e13)
  - site_page: https://fsd.how/docs/guides/issues/excessive-entities (fetched 2026-08-29T10:17:36.968520+00:00, sha d59b25343ca0)
  - site_page: https://fsd.how/docs/get-started/faq (fetched 2026-08-29T10:17:36.970317+00:00, sha 165167aeefb2)
- Data as of 2026-08-30T08:39:29.467469+00:00.