miro-local-dev-loop

# Miro Local Dev Loop ## Overview Set up a fast local development workflow for building Miro integrations, including hot reload, test mocking against the REST API v2, and ngrok tunneling for webhooks. ## Prerequisites - Completed `miro-install-auth` setup - Node.js 18+ with npm or pnpm - Access token with `boards:read` and `boards:write` scopes - ngrok (for webhook development) ## Instructions ### Step 1: Project Structure ``` my-miro-app/ ├── src/ │ ├── miro/ │ │ ├── client.ts # MiroApi wrapper singleton │ │ ├── boards.ts # Board CRUD operations │ │ ├── items.ts # Item operations (sticky notes, shapes, etc.) │ │ └── types.ts # Response type definitions │ ├── webhooks/ │ │ └── handler.ts # Webhook event processing │ └── index.ts ├── tests/ │ ├── miro-client.test.ts │ └── fixtures/ │ ├── board.json # Sample board response │ └── sticky-note.json # Sample item response ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team ├── package.json └── tsconfig.json ``` ### Step 2: Package Configuration ```json { "scripts": { "dev": "tsx watch src/index.ts", "test": "vitest", "test:watch": "vitest --watch", "test:integration": "MIRO_TEST_MODE=live vitest run tests/integration/", "tunnel": "ngrok http 3000", "typecheck": "tsc --noEmit" }, "dependencies": { "@mirohq/miro-api": "^2.0.0", "express": "^4.18.0", "...