atomic-design-guide

Guide React component structure using Atomic Design principles.

3|Updated Apr 5, 2024
One-click install
npx skills add https://github.com/danghungtb26/admin-react-typescript-template --skill atomic-design-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atomic-design-guide
Source: https://github.com/danghungtb26/admin-react-typescript-template/tree/main/.agents/skills/atomic-design-guide
Command: npx skills add https://github.com/danghungtb26/admin-react-typescript-template --skill atomic-design-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide addresses the challenge of maintaining scalable, consistent React component architectures across large applications by applying Atomic Design principles.

Core Features & Use Cases

  • Clear separation of atoms, molecules, organisms, and boxes to encourage proper placement and reuse.
  • Decision framework for when to extract components into shared patterns or feature-specific structures.
  • Practical scenarios and guidelines to refactor and organize components as projects evolve.

Quick Start

To begin, review your current component structure and categorize components into atoms, molecules, organisms, and boxes; then move or refactor accordingly. For example, place small UI primitives in src/components/atoms, composed patterns in src/components/molecules, and data-driven or complex components in src/components/organisms or feature containers.

Frequently Asked Questions about atomic-design-guide

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

FAQPage Schema
How do I structure React components with Atomic Design principles?

Structure React components by categorizing them into atoms, molecules, organisms, and boxes, placing UI primitives in src/components/atoms and complex data-driven components in src/components/organisms or feature containers to improve consistency.

What is the difference between atoms, molecules, and organisms in React component architecture?

In React component architecture, atoms are small UI primitives, molecules are composed patterns combining atoms, and organisms are complex, data-driven components or feature containers that structure large application interfaces.

When should I extract a React component into shared patterns or feature-specific structures?

Extract a React component into shared patterns when it serves multiple features for reuse, or into feature-specific structures when it handles isolated data-driven logic, following a decision framework to align with scalable codebase goals.

Can I use Atomic Design to refactor existing React project structures?

Yes, you can refactor existing React projects by reviewing your current component structure, categorizing components into atoms, molecules, organisms, and boxes, then moving or refactoring them accordingly to enforce architectural consistency.

Does Atomic Design work for organizing scalable React codebases and design systems?

Atomic Design works for scalable React codebases by enforcing clear separation of concerns across component levels, aligning with design-system goals to maintain consistency and reusability across large applications during architecture reviews.

What are the limitations of organizing React components into atoms, molecules, and organisms?

A limitation of organizing React components into atoms, molecules, and organisms is the potential overhead of deciding boundaries for complex components, requiring a strict decision guide to avoid misplacing patterns across feature folders and shared structures.