@createlex/figma-swiftui-mcp 1.2.0 → 1.2.4

package/companion/bridge-server.cjs

@@ -276,7 +276,23 @@ function startBridgeServer(options = {}) {
       return res.status(502).json({ ok: false, error: response.error || 'Plugin returned an error' });
     }
 
-    res.json({ ok: true, ...(response.data || {}) });
+    const data = response.data || {};
+
+    // Attach explicit AI workflow instructions so any agent that fetches this URL
+    // knows exactly how to generate and write correct SwiftUI code with real images.
+    const assetCount = data.assetExportPlan?.candidates?.length ?? 0;
+    const aiWorkflow = {
+      step1: 'You have the Figma design context. Do NOT generate SwiftUI code from scratch — that produces grey placeholder rectangles instead of real images.',
+      step2: 'Call the MCP tool `write_selection_to_xcode`. It generates SwiftUI with correct Image("name") asset references AND writes the PNG files to Assets.xcassets automatically.',
+      step3: 'After write_selection_to_xcode returns, ONLY refine the code it produced: add GeometryReader for responsiveness, wire interactions. DO NOT rewrite Image("name") calls or replace them with Rectangle()/shapes.',
+      step4: 'If the caller has no MCP access, use the structName and assetExportPlan below to write SwiftUI that references Image("name") for every asset candidate listed.',
+      mcpTool: 'write_selection_to_xcode',
+      mcpServer: 'figma-swiftui',
+      assetCandidateCount: assetCount,
+      warning: 'Photos, 3D renders, illustrations and icons are pre-exported as PNG assets. Always use Image("name") — never reconstruct them with SwiftUI shapes or colors.',
+    };
+
+    res.json({ ok: true, ...data, _aiWorkflow: aiWorkflow });
   });
 
   function sendBridgeMessage(ws, payload) {

package/companion/mcp-server.mjs

@@ -706,7 +706,7 @@ server.registerTool('analyze_generation', {
 });
 
 server.registerTool('write_generated_swiftui_to_xcode', {
-  description: 'Write generated SwiftUI code and optional exported images directly into the configured Xcode project. Supports writing multiple files: use additionalFiles for DesignTokens.swift (dir: "shared"), reusable components (dir: "components"), or extra screen files (dir: "screens"). AI tools generating code with their own model should call this after generating SwiftUI from get_design_context or get_swiftui_generation_prompt.',
+  description: 'Write generated SwiftUI code into the configured Xcode project. Images are automatically exported from the current Figma selection and written to Assets.xcassets — you do not need to provide them manually. Supports multiple files: use additionalFiles for DesignTokens.swift (dir: "shared"), reusable components (dir: "components"), or extra screen files (dir: "screens"). AI tools generating code with their own model should call this after generating SwiftUI from get_design_context or the /design-context URL.',
   inputSchema: {
     code: z.string().describe('SwiftUI source code for the primary view'),
     structName: z.string().optional().describe('Optional Swift struct name; if omitted it will be inferred from the code'),
@@ -725,11 +725,31 @@ server.registerTool('write_generated_swiftui_to_xcode', {
 }, async ({ code, structName, projectPath, images, selectionNames, additionalFiles }) => {
   const targetDir = resolveTargetProjectPath(projectPath);
   const effectiveStructName = inferStructName({ structName, code, selectionNames });
+
+  // Auto-fetch images from the current Figma selection when none were provided.
+  // This ensures Assets.xcassets is always populated even when the AI supplied
+  // its own SwiftUI code (e.g. from get_design_context / the /design-context URL).
+  let effectiveImages = Array.isArray(images) && images.length > 0 ? images : [];
+  if (effectiveImages.length === 0) {
+    try {
+      const generated = await callBridge('generate_swiftui', {
+        includeImages: true,
+        generationMode: 'editable',
+        includeOverflow: false,
+      });
+      if (Array.isArray(generated.images) && generated.images.length > 0) {
+        effectiveImages = generated.images;
+      }
+    } catch {
+      // Non-fatal: bridge may not be connected or selection may have no images.
+    }
+  }
+
   const result = writeSwiftUIScreen({
     targetDir,
     code,
     structName: effectiveStructName,
-    images,
+    images: effectiveImages,
     additionalFiles,
   });
 
@@ -740,6 +760,7 @@ server.registerTool('write_generated_swiftui_to_xcode', {
   return jsonResult({
     ...stripImageData(result),
     structName: effectiveStructName,
+    imagesWritten: effectiveImages.length,
   });
 });
 
@@ -811,6 +832,8 @@ server.registerTool('write_selection_to_xcode', {
     filePath: result.results?.swiftFile ?? null,
   });
 
+  const imageNames = (generated.images ?? []).map((img) => img.name);
+
   return jsonResult(buildCompactResponse({
     result,
     structName: effectiveStructName,
@@ -818,6 +841,14 @@ server.registerTool('write_selection_to_xcode', {
     diagnostics: generated.diagnostics ?? [],
     refinementInstructions,
     analysisHints,
+    _critical: [
+      `✅ SwiftUI written to ${result.results?.swiftFile ?? 'Xcode'}. Images written to Assets.xcassets.`,
+      imageNames.length > 0
+        ? `🖼  ${imageNames.length} PNG asset(s) written: ${imageNames.join(', ')}. The generated code already references them with Image("name") calls.`
+        : null,
+      '🚫 DO NOT rewrite or overwrite the generated Swift file. DO NOT replace Image("name") calls with Rectangle(), shapes, or colors.',
+      '✏️  You may ONLY: add GeometryReader for responsiveness, wire @State interactions, extract reusable sub-views. Nothing else.',
+    ].filter(Boolean),
   }));
 });
 
@@ -940,8 +971,16 @@ function buildRefinementInstructions({ diagnostics, rasterNodes, analysisHints,
 
   // Raster replacements
   if (rasterNodes.length > 0) {
+    const rasterNames = rasterNodes
+      .map((d) => d.assetName || d.nodeName || d.name)
+      .filter(Boolean)
+      .slice(0, 8)
+      .join(', ');
     instructions.push(
-      `${rasterNodes.length} element(s) were exported as raster images because Figma could not map them to native SwiftUI. Review these and replace obvious UI controls (buttons, text fields, toggles, tab bars) with native SwiftUI equivalents. Keep actual images/illustrations as Image assets.`
+      `IMPORTANT: ${rasterNodes.length} element(s) were rasterized and written to Assets.xcassets as PNG files${rasterNames ? ` (${rasterNames})` : ''}. ` +
+      `The generated code already references them with Image("name") calls — DO NOT remove or replace these Image() calls. ` +
+      `Only replace Image() calls if the asset name clearly identifies a native UI control (button, toggle, tab bar, text field). ` +
+      `Photos, illustrations, 3D renders, icons, and decorative graphics MUST stay as Image("name") — do not attempt to reconstruct them with SwiftUI shapes or colors.`
     );
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createlex/figma-swiftui-mcp",
-  "version": "1.2.0",
+  "version": "1.2.4",
   "description": "CreateLex MCP runtime for Figma-to-SwiftUI generation and Xcode export",
   "bin": {
     "figma-swiftui-mcp": "bin/figma-swiftui-mcp.js"
@@ -41,8 +41,7 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "openai": "^4.100.0"
+    "@anthropic-ai/sdk": "^0.52.0"
   },
   "devDependencies": {
     "@figma/plugin-typings": "*",