Skip to main content

Figma Angular React Vue Python MCP PyPI

🔥 FigmaForge

Forge production-ready components from Figma designs

Multi-framework code generation (Angular, React, Vue, Web Components) via CLI & Copilot Chat

Features • Quick Start • Usage • Frameworks • Docs


✨ Features

Core Features

Feature Description
🎯 Pixel-Perfect Exact positioning, colors, typography from your designs
🤖 AI-Driven Generate via VS Code Copilot Chat with natural language
⌨️ CLI Support Command-line interface for scripting and CI/CD
🎨 Design Tokens Extract colors, fonts, spacing as SCSS variables
📦 Asset Export Automatic SVG/PNG extraction with inline optimization
🔄 Non-Destructive Regenerate without losing custom code

Multi-Framework Support

Framework Output Files Flag
Angular .ts, .html, .scss --framework angular
React .tsx, .module.css --framework react
Vue 3 .vue (SFC) --framework vue
Web Components .js (Custom Elements) --framework webcomponent

Advanced Features

Feature Description
⚡ API Caching Local cache with ETag support for faster regeneration
🌐 Responsive Mode Flexbox layouts instead of absolute positioning
🎨 Tailwind CSS Generate Tailwind utility classes instead of SCSS
👀 Watch Mode Auto-regenerate components when Figma file changes
🔀 Component Variants Detect Figma variants → typed @Input() properties
🎭 Interaction States Map hover/focus/disabled variants to CSS pseudo-classes
📐 Figma Variables Extract design tokens from Figma Variables API

🚀 Quick Start

pip install figmaforge

Option 2: Clone Repository

git clone https://github.com/bipuldikshit/FigmaForge.git
cd FigmaForge
python -m venv .venv
.venv\Scripts\activate        # Windows
source .venv/bin/activate     # Mac/Linux
pip install -r requirements.txt

Configure Figma Token

# Set environment variable
export FIGMA_TOKEN=your-token-here  # Mac/Linux
$env:FIGMA_TOKEN="your-token-here"  # Windows

💡 Get your Figma token at figma.com/settings


🎮 Usage

🤖 AI-Driven (VS Code Copilot Chat)

  1. Open project in VS Code
  2. Reload window (Ctrl+Shift+P → "Developer: Reload Window")
  3. Open Copilot Chat (Ctrl+Shift+I)
  4. Chat naturally:
📝 "List all components in file ABC123XYZ"

🔥 "Generate a React component called hero-section from node 1:23 in file ABC123XYZ"

🎯 "Generate button from node 2:45 in file ABC123XYZ with tailwind styling and responsive layout"

⌨️ CLI Commands

# Generate Angular component (default)
python cli.py generate -f FILE_KEY -n "1:23" -m my-button

# Generate React component
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --framework react

# Generate Vue component
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --framework vue

# Generate Web Component
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --framework webcomponent

# With Tailwind CSS
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --style tailwind

# Responsive flexbox layout
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --responsive

# Dry run (preview without writing)
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --dry-run

# Bypass cache
python cli.py generate -f FILE_KEY -n "1:23" -m my-button --no-cache

# Cache management
python cli.py cache          # View cache stats
python cli.py cache --clear  # Clear all cached data

# Watch mode (auto-regenerate on changes)
python cli.py watch -f FILE_KEY -n "1:23" -m my-button --interval 30

# Sync file and extract design tokens
python cli.py sync -f FILE_KEY

# Initialize project directories
python cli.py init

🔧 Frameworks

Angular (Default)

python cli.py generate -f FILE -n NODE -m button

Generates: button.component.ts, button.component.html, button.component.scss

React

python cli.py generate -f FILE -n NODE -m button --framework react

Generates: Button.tsx, Button.module.css

Vue 3

python cli.py generate -f FILE -n NODE -m button --framework vue

Generates: Button.vue (Single File Component with Composition API)

Web Components

python cli.py generate -f FILE -n NODE -m button --framework webcomponent

Generates: Button.js (Custom Element with Shadow DOM)


🔍 Finding Figma IDs

ID Location Example
File Key URL: figma.com/design/ABC123XYZ/... ABC123XYZ
Node ID Right-click → "Copy link" → ?node-id=1-23 1:23

📂 Project Structure

FigmaForge/
├── cli.py                    # CLI entry point
├── mcp_stdio_server.py       # MCP server for Copilot Chat
├── .vscode/mcp.json          # VS Code MCP configuration
├── src/
│   ├── figma/                # Figma API client & normalizer
│   ├── generators/           # Angular, React, Vue, WebComponent generators
│   ├── extractors/           # Tokens, variants, assets, interaction states
│   └── utils/                # CSS utilities, console output
├── tests/                    # Unit tests (33+ tests)
└── docs/                     # Documentation

⚙️ Configuration

Variable Description Default
FIGMA_TOKEN Your Figma personal access token Required
ANGULAR_OUTPUT_PATH Component output directory ./src/app/components
ASSETS_OUTPUT_PATH Asset output directory ./src/assets/figma

🛠️ MCP Tools (Copilot Chat)

Tool Description
generate_component Generate component (any framework)
sync_figma Sync file & extract tokens
list_components List all components in file
preview Get raw design JSON
extract_tokens Export SCSS variables

MCP Parameters

Parameter Values Description
framework angular, react, vue, webcomponent Target framework
styleFormat scss, tailwind Style output format
responsive true/false Use flexbox layouts
dryRun true/false Preview without writing
noCache true/false Bypass API cache

🧪 Testing

# Run all tests
python -m pytest tests/ -v

# Run with coverage
python -m pytest tests/ --cov=src --cov-report=term-missing

📚 Documentation


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🔥 FigmaForge — Forging code from designs

Metadata

Release files for figmaforge 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for figmaforge 1.0.2
File Size Uploaded Provenance Actions
figmaforge-1.0.2.tar.gz 54.1 kB Without provenance Details for figmaforge-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for figmaforge 1.0.2
File Interpreter ABI Platform Actions
figmaforge-1.0.2-py3-none-any.whl Python 3 none any Details for figmaforge-1.0.2-py3-none-any.whl

Total release size: 120.2 kB

Release files / figmaforge-1.0.2.tar.gz

Download URL figmaforge-1.0.2.tar.gz
Size 54.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c24a148d15f03e8fde7f5654ace7fbfc9fad9521cccc9363ae2d37e7bb393418
BLAKE2b-256 checksum
How to use checksums
c464ef5194d86f28e80ad472a6af08f9975a9a34b4898e203e4bfe14df3b64f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.9

Release files / figmaforge-1.0.2-py3-none-any.whl

Download URL figmaforge-1.0.2-py3-none-any.whl
Size 66.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc38dd58aa106720e5d24119f22b5196b61df0bc48b4dc08cf712fd837a255c0
BLAKE2b-256 checksum
How to use checksums
974dfb7d63ee7cf60eead7c78e9c14bed4c0be6208540a9a47be387eaeab566e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.9

Security for figmaforge 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page