v1.0.0-beta.5 — 19 Tools: React Native, Flutter, SwiftUI Mappers

What's New — 4 Platform Mappers on Shared AST

All platform mappers reuse the same Normalized UI AST — write once, emit everywhere.

map_to_react_native (NEW)

• StyleSheet output with proper RN conventions
• React Native Paper and NativeBase component detection
• View, Text, TouchableOpacity, TextInput, Image, ScrollView

map_to_flutter (NEW)

• Flutter Widget tree: Container, Column, Row, Stack, SizedBox
• Material and Cupertino component mapping
• ThemeData extraction (colors, font families, sizes)

map_to_swiftui (NEW)

• VStack/HStack/ZStack with modifier chains
• Color(red:green:blue:opacity:) format (no extension needed)
• Color asset extraction with named colors

Quality

• 60 unit tests for normalized-ui-ast (all passing)
• All 3 mappers reviewed by Codex — 10 issues found and fixed
• Correct Flutter Color(0xAARRGGBB) format
• Correct RN shadowOffset as object
• Full alpha preservation across all platforms

Full Tool Count: 19

inspect_layout, extract_design_tokens, map_to_unity, map_to_react, map_to_react_native, map_to_flutter, map_to_swiftui, resolve_components, extract_flows, bridge_to_codebase, diff_versions, extract_variants, export_images, audit_accessibility, simplify_context, lint_handoff_readiness, generate_implementation_contract, extract_missing_states, flow_to_test_cases

npm: npx figma-spec-mcp@beta (requires npm publish with 2FA — pending)

v1.0.0-beta.4 — map_to_react + Normalized UI AST

What's New

map_to_react — Figma → React Component Tree

Map any Figma frame to a React-ready component tree with:

• 4 style formats: Tailwind (real utility classes), CSS Modules, Styled Components, inline styles
• 5 component libraries: shadcn/ui, MUI, Chakra UI, Radix UI, plain HTML
• Component detection: Button, Input, Card, Avatar, Badge, Checkbox, Select, Divider
• Variant → Props: Figma variants automatically mapped to TypeScript prop interfaces (Size→sm/md/lg, State→disabled, Variant→default/outline/ghost)
• Asset hints: SVG/PNG format suggestions with dimensions for every image/icon node
• Semantic HTML: h1/h2/p/span/button/input/hr/img/div inference from node type and size

Normalized UI AST Foundation

New shared normalized-ui-ast module converts raw Figma node trees into a platform-agnostic UI representation. This is the foundation for upcoming platform mappers (Flutter, SwiftUI, React Native) — build once, emit everywhere.

Full Changelog

• feat: add map_to_react tool (16th tool)
• feat: add normalized-ui-ast.ts shared utility
• docs: update README with React platform support, v0.6 section, updated roadmap
• chore: bump to 1.0.0-beta.4

npm: npx figma-spec-mcp@beta

Full Docs: https://github.com/zaferdace/figma-spec-mcp#readme

v1.0.0-beta.3

figma-spec-mcp v1.0.0-beta.3

15 MCP tools for Figma → structured specs

Install: npx figma-spec-mcp@beta

Tools

Category	Tools
Core	inspect_layout, extract_design_tokens, map_to_unity
Intelligence	Token name preservation, depth chunking, rich text, annotations, framework hints
Workflows	resolve_components, extract_flows, bridge_to_codebase, diff_versions, extract_variants
Quality	export_images, audit_accessibility, simplify_context
Handoff & QA	lint_handoff_readiness, generate_implementation_contract, extract_missing_states, flow_to_test_cases

Highlights

• SonarCloud: All A (Security, Reliability, Maintainability)
• WCAG 2.1 accessibility audit with contrast ratios
• AI-optimized context simplification for LLM token efficiency
• Tool registry pattern — easy to contribute new tools
• Disk cache with 1h TTL, rate limit handling (429 + Retry-After)

Works with any MCP client

Claude Code, Claude Desktop, Cursor, VS Code + Copilot, Windsurf, Cline, Zed

Full changelog: https://github.com/zaferdace/figma-spec-mcp/blob/main/CHANGELOG.md

v1.0.0-beta.2

Bug fixes: resolve_components graceful 404 handling, CI pipeline fix, SonarCloud all-A.

v1.0.0-beta.1

Initial beta release — 11 tools, npm published.