miro-migration-deep-dive

# Miro Migration Deep Dive ## Overview Comprehensive guide for migrating Miro boards between teams and organizations, updating from REST API v1 to v2, and re-platforming from competing whiteboard tools (Lucidchart, FigJam). Covers board content export with cursor pagination, bulk import with rate-limit aware queuing, widget API changes between v1 and v2, and the new app framework patterns. Typical migration scope: dozens to thousands of boards with connectors, tags, and members. ## Migration Assessment ```typescript // Scan current integration for deprecated v1 patterns and board inventory async function assessMigration(teamId: string) { const boards = await miroFetch(`/v2/boards?team_id=${teamId}&limit=50`); let totalItems = 0; for (const board of boards.data) { const items = await miroFetch(`/v2/boards/${board.id}/items?limit=1`); totalItems += items.total ?? 0; } console.log(`Team ${teamId}: ${boards.data.length} boards, ~${totalItems} items`); console.log('API version: v2 (v1 deprecated 2024-01)'); console.log('Widget types to migrate: sticky_note, shape, card, text, frame, image, connector'); return { boardCount: boards.data.length, totalItems }; } ``` ## Step-by-Step Migration ### Phase 1: Prepare — Export Source Boards Export every item on a board to a structured JSON file with cursor-paginated reads: ```typescript interface BoardExport { exportedAt: string; board: { id: string; name: string; description: string; owner: { id: string;...