feature-sliced-design

Guide frontend project structuring with Feature-Sliced Design v2.1 layers and import rules.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/xmun74/chordlens --skill feature-sliced-design-xmun74
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-sliced-design
Source: https://github.com/xmun74/chordlens/tree/main/.claude/skills/feature-sliced-design
Command: npx skills add https://github.com/xmun74/chordlens --skill feature-sliced-design-xmun74

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Feature-Sliced Design (FSD) v2.1 provides a disciplined blueprint for structuring modern frontend projects, offering clear layering, domain-based naming, and import-boundary rules to reduce coupling and accelerate collaboration.

Core Features & Use Cases

  • Layered architecture with app, views, shared, features, and entities, enforcing a bottom-up import policy.
  • Public API discipline: per-slice index.ts exports to create stable, framework-agnostic boundaries.
  • Migration & framework integration: guidance for moving from v2.0 or non-FSD baselines and for integrating with Next.js, Vite, Nuxt, etc.
  • Cross-import strategies (merge, extract to entities, or compose at a higher layer) to minimize tight coupling.

Quick Start

Describe how to apply FSD v2.1 to organize a frontend project, define the layers, and enforce import boundaries.

Frequently Asked Questions about feature-sliced-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a frontend project using Feature-Sliced Design?

Feature-Sliced Design structures frontend projects into app, views, shared, features, and entities layers. This enforces a bottom-up import policy and domain-based naming to reduce coupling and accelerate team collaboration.

Why does Feature-Sliced Design enforce a public API for each slice?

Feature-Sliced Design enforces a public API through per-slice index.ts exports to create stable, framework-agnostic boundaries. This discipline prevents direct internal access and maintains scalable, maintainable frontend architecture.

How do I migrate an existing frontend to FSD v2.1 from v2.0 or non-FSD baselines?

Migrate to FSD v2.1 by progressively reorganizing existing code into the defined layers and establishing public API contracts. The approach provides specific migration guidance for moving from v2.0 or non-FSD baselines.

Does Feature-Sliced Design work with Next.js, Vite, or Nuxt?

Feature-Sliced Design works with Next.js, Vite, and Nuxt by providing specific framework integration guidance. It applies framework-agnostic layering rules and boundary enforcement to maintain a scalable frontend architecture.

What is the best way to handle cross-imports between features in a layered frontend architecture?

Handle cross-imports in a layered frontend architecture by merging features, extracting shared logic to entities, or composing them at a higher layer. These strategies minimize tight coupling and maintain import boundary rules.

What are the limitations of using FSD for frontend architecture?

Limitations of using FSD include the strict overhead of maintaining per-slice public APIs and managing import boundaries. Teams must carefully navigate cross-import strategies to avoid tight coupling when scaling complex frontend projects.