atomic-page-builder

Build pages using ONLY existing atomic-design components. REQUIRES atomic-design skill. Use for composing pages, creating views/features from existing components.

⭐5stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The Atomic Page Builder is a high-precision frontend development skill designed to compose web pages and features exclusively using an existing Atomic Design system. It bridges the gap between design and implementation by treating Figma as the absolute source of truth, ensuring 100% visual fidelity through automated extraction of layout specs, grids, and design tokens while strictly prohibiting the creation of redundant components.

Use Cases

  • Figma-to-Code Translation: Automatically generate React/TSX page structures by extracting exact spacing, grid, and padding values from Figma nodes to match designs perfectly.
  • Design System Enforcement: Ensure all new views are built strictly with authorized atoms, molecules, and organisms, preventing technical debt and UI inconsistency.
  • Rapid Feature Prototyping: Quickly assemble complex application dashboards or landing pages by mapping user requirements to an existing library of UI components.
  • Responsive Layout Implementation: Precise application of mobile and desktop layout overrides based on Figma specifications using CSS Modules and design tokens.
  • Gap Analysis & UI Auditing: Identify missing components in a design system by comparing Figma requirements against the current component inventory before starting development.
nameatomic-page-builder
descriptionBuild pages using ONLY existing atomic-design components. REQUIRES atomic-design skill. Use for composing pages, creating views/features from existing components.

Atomic Page Builder

Compose pages using ONLY existing atomic-design components.

Critical Rule: Figma Is Source of Truth

NEVER guess layout. ALWAYS extract EXACT page specs from Figma first.

Figma-First Workflow

1. EXTRACT PAGE SPECS FROM FIGMA (Mandatory)
   - Use Figma MCP: get_node
   - Extract: grid, gaps, padding, margins
   - Identify components used
   - Note page-specific overrides

2. COMPARE WITH TOKENS
   - Check spacing tokens match Figma
   - If different -> UPDATE tokens (Figma wins)

3. IMPLEMENT EXACTLY
   - Match Figma layout 1:1
   - NO "improvements"

Rules

Forbidden Required
Creating new atoms/molecules/organisms Use existing components only
Guessing layout values Extract from Figma
External UI libs (MUI, Chakra) Design system imports only
Hardcoded values (#333, 24px) CSS Modules + tokens
Rounding values Exact Figma values

Decision Tree

User: "Build page"
  -> Step 0: EXTRACT FROM FIGMA (mandatory)
  -> Step 1: INVENTORY (scan existing components)
  -> Step 2: GAP ANALYSIS (map requirements to components)
  -> Step 3: BUILD OR STOP
       All exist? -> Compose page
       Missing?   -> STOP, report gaps, switch to atomic-design

Page Composition

/**
 * Dashboard Page
 * @figma https://figma.com/file/xxx?node-id=123
 * @extracted 2024-01-15
 * Layout specs from Figma - DO NOT MODIFY
 */

import { DashboardLayout } from '@/templates/DashboardLayout';
import { Card } from '@/molecules/Card';
import { DataTable } from '@/organisms/DataTable';
import styles from './Dashboard.module.css';

export const Dashboard = () => (
  <DashboardLayout>
    <div className={styles.statsGrid}>
      <Card title="Revenue">$12,450</Card>
    </div>
    <DataTable columns={columns} data={data} />
  </DashboardLayout>
);
/* Dashboard.module.css - ALL values from Figma */
.statsGrid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);  /* From Figma */
  gap: var(--spacing-6);                   /* From Figma */
}

@media (max-width: 768px) {
  .statsGrid {
    grid-template-columns: 1fr;            /* Figma mobile */
    gap: var(--spacing-4);
  }
}

Import Pattern

import { Button } from '@/design-system/atoms/Button';
import { Card } from '@/design-system/molecules/Card';
import { Header } from '@/design-system/organisms/Header';
import { DashboardLayout } from '@/design-system/templates/DashboardLayout';

Skill Switching

Situation Action
Missing atom/molecule/organism -> atomic-design
Need new tokens -> atomic-design
Token value changed in Figma -> atomic-design (update first)
Composing from existing Stay here

Output Checklist

  • Page specs extracted from Figma
  • Layout values match Figma exactly
  • Responsive matches Figma
  • Visual comparison 0% difference
  • Figma link documented
  • All imports from design system
  • Zero hardcoded values
  • Zero new components