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