---
name: blocks-figma-connect
description: Authors and updates Figma Code Connect templates (*.figma.tsx) for @chainlink/blocks. For internal maintainers. Triggers on libs/blocks/**/*.figma.tsx, mapping Figma props to public Blocks APIs, or validating Code Connect output against source and stories—not on shipping app pages from Figma.
---

# Blocks Figma Code Connect (maintainers)

**Scope:** `libs/blocks/**/*.figma.tsx`.

**Normative spec:** [reference/FIGMA_CODE_CONNECT_GUIDE.md](reference/FIGMA_CODE_CONNECT_GUIDE.md). All mapping rules and checklist live there—**the guide wins** over any summary here or in chat.

**Out of scope:** app pages from Figma → **`blocks-ui-builder`**; MDX/stories → **`blocks-mdx`** / **`blocks-stories`**.

## Prerequisites

1. `../../AGENTS.md`
2. [reference/FIGMA_CODE_CONNECT_GUIDE.md](reference/FIGMA_CODE_CONNECT_GUIDE.md)
3. Each mapped component: **`.tsx`**, **`.stories.tsx`**, **`.mdx`** under `../../src/components/<Name>/`. Generated snippets are not shippable until validated against source.

## Workflow

```
- [ ] reference/FIGMA_CODE_CONNECT_GUIDE.md read for this change
- [ ] Every mapped component checked in .tsx + .stories + .mdx
- [ ] Typecheck / repo Code Connect or Storybook checks when configured
```

### 1. Classify

New mapping vs update vs prop sync—smallest edit that satisfies the guide and source.

### 2. Edit

Follow **[reference/FIGMA_CODE_CONNECT_GUIDE.md](reference/FIGMA_CODE_CONNECT_GUIDE.md)** only.

### 3. Validate

Run package typecheck and any configured Code Connect / Storybook validation.

## Report

Files touched; checks; snippet vs source/story mismatches.