@createlex/figma-swiftui-mcp 1.2.2 → 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

@@ -832,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,
@@ -839,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),
   }));
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createlex/figma-swiftui-mcp",
-  "version": "1.2.2",
+  "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"