Skip to content

Figma component pages: one doc card with a real description - #35

Merged
MartaCondeDesign merged 6 commits into
mainfrom
claude/figma-doc-cards
Oct 22, 2026
Merged

MartaCondeDesign merged 6 commits into
mainfrom
claude/figma-doc-cards

Conversation

@MartaCondeDesign

Copy link
Copy Markdown
Owner

The owner's layout for every Figma component page (2026-10-22): one white rounded card with the component's name, its description, a divider edge to edge, and below it the Propstar table(s) with their labels.

Description. It's the component's purpose from its {Name}.doc.ts, the same sentence its Storybook docs page opens with (owner's choice). Before, the page showed conversion notes or loose fragments; Button's even said "5 sizes (xs → xl)".

Tokens (owner's choice): fill/page, radius/2xl, padding spacing/layout/l, gaps spacing/layout/m, divider border/neutral. Title is Heading / 3xl / Bold, description Body / l / Regular, and a child set's name Heading / m / Bold.

What's in this PR

  • scripts/figma/doc-card.js draws the card on one or more pages. It's safe to re-run: it keeps every table and component and rewrites the texts. A child set (ChartTooltip, MenuItem, SegmentedControlItem, TableRow…) gets its name above its table.
  • pnpm figma:doc-cards [Name…] prints that script with the descriptions filled in from the .doc.ts files, so they can't drift from Storybook.
  • propstar.js no longer overwrites the page description with the set's conversion note. When it regenerates a table, the card stays auto-layout and hugs it.
  • The Figma audit has a new docCard check: header, divider, body, vertical auto-layout, fill bound to fill/page, and a description that isn't a conversion note.
  • CLAUDE.md rule 12 and components-to-figma.md describe the card. The skill's new Phase 7b says to run it on every new or changed component, in both Figma files.

Figma. All 29 core pages of the working file are redone. The new check passes on all 36 sets and components, and no leftover nodes remain. The Figma Community copy lives in another account, so the owner updates it (Phase 8).

🤖 Generated with Claude Code

MartaCondeDesign and others added 6 commits October 22, 2026 13:43
…description, a divider, then the Propstar tables (doc-card.js, pnpm figma:doc-cards, audit check)
…n table (hard-stop gradient when only some variants need it); every Figma change goes into both files (figmaCommunityFileKey)
…ells the agent to run it on the martacondedieguez file too
@MartaCondeDesign
MartaCondeDesign merged commit 394823a into main Oct 22, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant