@createlex/figgen 1.4.2

package/README.md

@@ -0,0 +1,164 @@
+# CreateLex Figma to SwiftUI MCP
+
+A local MCP (Model Context Protocol) runtime that connects your Figma plugin session to Claude Code, Cursor, Windsurf, or any MCP-compatible AI tool — and writes production-ready SwiftUI directly into your Xcode project.
+
+## Generation tiers
+
+### Tier 1 — AI-native (zero extra API cost)
+Your AI IDE (Claude Code, Cursor, Windsurf, etc.) calls the MCP tools itself:
+
+1. `get_swiftui_generation_prompt` → returns a ready-to-use system prompt + user message
+2. The AI generates SwiftUI using **its own model** (your existing subscription)
+3. `write_generated_swiftui_to_xcode` → writes the file(s) to Xcode
+
+No CreateLex tokens consumed. No extra API keys required.
+
+### Tier 2 — BYOK (Bring Your Own Key)
+Set one of these env vars in your MCP client config and `generate_swiftui` runs locally:
+
+| Env var | Provider | Notes |
+|---|---|---|
+| `ANTHROPIC_API_KEY` | Claude (recommended) | Override model with `ANTHROPIC_MODEL` |
+| `HF_API_TOKEN` | Hugging Face | Default model: `Qwen/Qwen2.5-Coder-32B-Instruct`, override with `HF_MODEL` |
+| `OPENAI_API_KEY` | OpenAI or compatible | Override model with `OPENAI_MODEL` (default `gpt-4o`) |
+| `OPENAI_BASE_URL` | Ollama / LM Studio | Set alongside `OPENAI_API_KEY=ollama` for fully local generation |
+
+### Tier 3 — CreateLex hosted (subscription fallback)
+If no BYOK keys are set, falls back to the CreateLex hosted pattern matcher. Requires an active [CreateLex subscription](https://createlex.com/figma-swiftui).
+
+---
+
+## Requirements
+
+- Node.js 18 or later
+- Figma desktop app with the Figma to SwiftUI plugin open
+- A local Xcode project (optional for Tier 1 prompt-copy workflow)
+
+## Install
+
+```bash
+npx @createlex/figma-swiftui-mcp start --project /path/to/MyApp/MyApp
+```
+
+Or install globally:
+
+```bash
+npm install -g @createlex/figma-swiftui-mcp
+figma-swiftui-mcp start --project /path/to/MyApp/MyApp
+```
+
+## MCP client configuration
+
+Add to your Claude Code / Cursor / Windsurf MCP config:
+
+```json
+{
+  "mcpServers": {
+    "figma-swiftui": {
+      "command": "npx",
+      "args": ["@createlex/figma-swiftui-mcp", "start"],
+      "env": {
+        "FIGMA_SWIFTUI_PROJECT_PATH": "/path/to/MyApp/MyApp",
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+For Hugging Face BYOK:
+
+```json
+{
+  "env": {
+    "FIGMA_SWIFTUI_PROJECT_PATH": "/path/to/MyApp/MyApp",
+    "HF_API_TOKEN": "hf_...",
+    "HF_MODEL": "Qwen/Qwen2.5-Coder-32B-Instruct"
+  }
+}
+```
+
+For fully local generation with Ollama:
+
+```json
+{
+  "env": {
+    "FIGMA_SWIFTUI_PROJECT_PATH": "/path/to/MyApp/MyApp",
+    "OPENAI_API_KEY": "ollama",
+    "OPENAI_BASE_URL": "http://localhost:11434/v1",
+    "OPENAI_MODEL": "llama3"
+  }
+}
+```
+
+## MCP tools
+
+| Tool | Description |
+|---|---|
+| `get_design_context` | Get the full Figma node tree, colors, typography, and layout for a selection |
+| `get_swiftui_generation_prompt` | Returns a ready-to-use system prompt + user message — feed to your AI model to generate SwiftUI |
+| `generate_swiftui` | Generate SwiftUI via BYOK key or CreateLex hosted (Tier 2/3) |
+| `write_generated_swiftui_to_xcode` | Write a generated Swift file (plus optional DesignTokens.swift and component files) to Xcode |
+| `get_project_path` / `set_project_path` | Read or update the target Xcode source directory |
+| `bridge_status` | Check if the Figma plugin bridge is connected |
+
+### Multi-file output
+
+`write_generated_swiftui_to_xcode` accepts an `additionalFiles` array for AI-generated companion files:
+
+```json
+{
+  "structName": "LoginScreen",
+  "code": "import SwiftUI\n...",
+  "additionalFiles": [
+    { "name": "DesignTokens.swift", "code": "...", "dir": "shared" },
+    { "name": "PrimaryButton.swift", "code": "...", "dir": "components" }
+  ]
+}
+```
+
+Output layout inside your Xcode source folder:
+
+```
+FigmaGenerated/
+  Screens/         ← primary view files
+  Components/      ← reusable component files
+  DesignTokens.swift  ← shared tokens (dir: "shared")
+  Manifest/        ← generation metadata
+```
+
+## AI-native workflow (Tier 1 example)
+
+In Claude Code or any MCP-connected AI:
+
+```
+1. Select a frame in Figma
+2. Ask: "Generate SwiftUI for my selected Figma frame"
+3. Claude calls get_swiftui_generation_prompt → generates code → calls write_generated_swiftui_to_xcode
+4. File appears in Xcode immediately
+```
+
+Zero CreateLex tokens consumed.
+
+## Plugin UI
+
+The plugin's **Smart Generate** button supports two modes via the dropdown:
+- **Smart AI** — uses your AI IDE or BYOK key for true AI generation
+- **Classic** — uses the hosted pattern matcher (requires subscription)
+
+After generation, the **Copy AI Prompt** button copies a ready-to-use prompt you can paste into Claude.ai, ChatGPT, or any AI chat. Requires the MCP server to be running.
+
+## Login (CreateLex subscription)
+
+Only required for Tier 3 hosted generation:
+
+```bash
+npx @createlex/figma-swiftui-mcp login
+```
+
+Saves your session to `~/.createlex/auth.json`.
+
+## Support
+
+- Product: https://createlex.com/figma-swiftui
+- Help & billing: https://createlex.com/contact

package/bin/figgen.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+
+const CLI_NAME = 'figgen';
+const PACKAGE_NAME = '@createlex/figgen';
+
+function printHelp() {
+  console.log(`${CLI_NAME}
+
+Usage:
+  npx ${PACKAGE_NAME} login
+  npx ${PACKAGE_NAME} start [--project /path/to/Xcode/source]
+  npx ${PACKAGE_NAME} setup [--force] [--dry-run]
+
+Commands:
+  login   Open the CreateLex browser login flow and save ~/.createlex/auth.json
+  start   Start the local figma-swiftui MCP runtime and localhost bridge
+  setup   Auto-configure MCP in Cursor, Claude, VS Code, Windsurf, and more
+  help    Show this help message
+  version Show the package version
+
+Examples:
+  npx ${PACKAGE_NAME} login
+  npx ${PACKAGE_NAME} start --project /Users/you/MyApp/MyApp
+  npx ${PACKAGE_NAME} setup
+  npm install -g ${PACKAGE_NAME}
+  ${CLI_NAME} start --project /Users/you/MyApp/MyApp
+`);
+}
+
+function printCommandHelp(command) {
+  if (command === 'login') {
+    console.log(`${CLI_NAME} login
+
+Usage:
+  npx ${PACKAGE_NAME} login
+
+Description:
+  Open the CreateLex browser login flow and save ~/.createlex/auth.json
+`);
+    return;
+  }
+
+  if (command === 'start') {
+    console.log(`${CLI_NAME} start
+
+Usage:
+  npx ${PACKAGE_NAME} start [--project /path/to/Xcode/source]
+
+Options:
+  --project <path>  Set the Xcode source folder used for generated SwiftUI output
+
+Description:
+  Start the local figma-swiftui MCP runtime and localhost bridge
+`);
+    return;
+  }
+
+  if (command === 'setup') {
+    console.log(`${CLI_NAME} setup
+
+Usage:
+  npx ${PACKAGE_NAME} setup [--force] [--dry-run]
+
+Options:
+  --force     Overwrite existing figma-swiftui config entries
+  --dry-run   Show what would be configured without writing
+
+Description:
+  Detects installed IDEs (Cursor, Claude Desktop, Claude Code, VS Code,
+  Windsurf, Antigravity) and adds the figma-swiftui MCP server entry
+  to each config file automatically.
+`);
+    return;
+  }
+
+  printHelp();
+}
+
+function resolveEntry(command) {
+  if (command === 'login') {
+    return path.join(__dirname, '..', 'companion', 'login.mjs');
+  }
+  return path.join(__dirname, '..', 'companion', 'mcp-server.mjs');
+}
+
+function runNode(entry, args) {
+  const child = spawn(process.execPath, [entry, ...args], {
+    stdio: 'inherit',
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 0);
+  });
+
+  child.on('error', (error) => {
+    console.error(`${CLI_NAME} failed: ${error.message}`);
+    process.exit(1);
+  });
+}
+
+const packageJson = require(path.join(__dirname, '..', 'package.json'));
+const [command = 'help', ...args] = process.argv.slice(2);
+const wantsHelp = args.includes('--help') || args.includes('-h');
+
+switch (command) {
+  case 'login':
+    if (wantsHelp) {
+      printCommandHelp('login');
+      break;
+    }
+    runNode(resolveEntry('login'), args);
+    break;
+  case 'start':
+    if (wantsHelp) {
+      printCommandHelp('start');
+      break;
+    }
+    runNode(resolveEntry('start'), args);
+    break;
+  case 'setup':
+    if (wantsHelp) {
+      printCommandHelp('setup');
+      break;
+    }
+    {
+      const { runSetup } = require(path.join(__dirname, '..', 'companion', 'setup.cjs'));
+      const flags = {
+        force: args.includes('--force'),
+        dryRun: args.includes('--dry-run'),
+      };
+      runSetup(flags);
+    }
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    printHelp();
+    break;
+  case 'version':
+  case '--version':
+  case '-v':
+    console.log(packageJson.version);
+    break;
+  default:
+    console.error(`Unknown command: ${command}\n`);
+    printHelp();
+    process.exit(1);
+}