figma-migration-deep-dive

# Figma Migration Deep Dive ## Overview Automate migration of design data between Figma files, from other tools to Figma, or from Figma styles to the Variables API. Covers inventory, extraction, transformation, and validation. ## Prerequisites - Source and destination Figma file keys - `FIGMA_PAT` with `file_content:read` and `file_variables:write` (Enterprise) scopes - Understanding of source file structure ## Instructions ### Step 1: Inventory Source File ```typescript const PAT = process.env.FIGMA_PAT!; async function inventoryFile(fileKey: string) { const res = await fetch( `https://api.figma.com/v1/files/${fileKey}`, { headers: { 'X-Figma-Token': PAT } } ); const file = await res.json(); const inventory = { name: file.name, pages: file.document.children.map((p: any) => p.name), componentCount: Object.keys(file.components).length, styleCount: Object.keys(file.styles).length, styles: { fills: Object.values(file.styles).filter((s: any) => s.style_type === 'FILL').length, text: Object.values(file.styles).filter((s: any) => s.style_type === 'TEXT').length, effects: Object.values(file.styles).filter((s: any) => s.style_type === 'EFFECT').length, grids: Object.values(file.styles).filter((s: any) => s.style_type === 'GRID').length, }, }; // Count total nodes let nodeCount = 0; function countNodes(node: any) { nodeCount++; if (node.children) node.children.forEach(countNodes); } countNodes(f...