figma-to-react

gbasin's avatarfrom gbasin

Convert Figma designs to pixel-perfect React components with Tailwind CSS.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 25, 2025

When & Why to Use This Skill

This Claude skill automates the transformation of Figma designs into production-ready, pixel-perfect React components using Tailwind CSS. By leveraging Figma MCP servers and a structured, status-driven workflow, it ensures high-fidelity implementation, handles design tokens, and performs automated visual validation to bridge the gap between design and front-end development.

Use Cases

  • Rapidly converting high-fidelity Figma mockups into functional React components with responsive Tailwind CSS styling.
  • Streamlining the design-to-code handoff process by automatically extracting design context, metadata, and screenshots.
  • Ensuring visual accuracy through automated dimension validation and visual regression checks against original Figma designs.
  • Implementing design systems efficiently by importing design tokens and mapping them directly to code-based configurations.
  • Reducing manual front-end development effort by generating structured, linted code that follows modern React best practices.
namefigma-to-react
version0.9.27
descriptionConvert Figma designs to pixel-perfect React components with Tailwind CSS.
licenseMIT
compatibilityRequires Figma MCP server (mcp__figma__*). React + Tailwind CSS project. Uses oxlint for fast linting.
allowed-toolsBash Read Write Edit Glob Grep Task WebFetch TodoWrite AskUserQuestion mcp__plugin_figma_figma__get_metadata mcp__plugin_figma_figma__get_screenshot mcp__plugin_figma_figma__get_design_context mcp__plugin_figma_figma-desktop__get_metadata mcp__plugin_figma_figma-desktop__get_screenshot mcp__plugin_figma_figma-desktop__get_design_context mcp__figma__get_metadata mcp__figma__get_screenshot mcp__figma__get_design_context

Figma to React

Convert Figma designs to pixel-perfect React components with Tailwind CSS.

Workflow

The workflow is a status-driven loop. Always check status before and after each step:

LOOP:
  1. Run: $SKILL_DIR/scripts/status.sh
  2. Read the step file for current_step (e.g., step-4b-validate-dimensions.md)
  3. Execute that step's instructions
  4. Go to step 1 (until step 8 complete)

Step Reference

Create a TodoWrite list with these steps (Glob to find each file):

1. Setup - step-1-setup.md
2. Detect structure - step-2-detect-structure.md
3. Confirm config - step-3-confirm-config.md
3b. Create preview route - step-3b-preview-route.md
4. Generate screens (parallel) - step-4-generation.md
4b. Validate dimensions - step-4b-validate-dimensions.md
5. Import tokens - step-5-import-tokens.md
6. Validate screens (parallel) - step-6-validation.md
7. Rename assets - step-7-rename-assets.md
8. Disarm hook - step-8-disarm-hook.md

Pre-flight Checks

Each step file has a pre-flight check. If status.sh says you're on step 4b but you're trying to execute step 5:

  1. STOP - don't execute step 5
  2. Update TodoWrite to uncheck wrongly-completed steps
  3. Read the correct step file (step 4b)

This prevents skipping steps, which was a common failure mode.

Recovery After Compaction

If context is compacted, run $SKILL_DIR/scripts/status.sh to see exactly where you are. The script infers state from /tmp files - no context needed.

State files used by status.sh:

  • /tmp/figma-to-react/capture-active - Skill is active
  • /tmp/figma-to-react/config.json - Config with screens/screenNames mapping
  • /tmp/figma-to-react/steps/4b/*.json - Dimension validation results
  • /tmp/figma-to-react/steps/4b/user-decisions.json - User decisions on missing dims
  • /tmp/figma-to-react/steps/5/complete.json - Token import done
  • /tmp/figma-to-react/validation/*/result.json - Visual validation results
  • /tmp/figma-to-react/steps/7/complete.json - Asset rename done