anima-webhooks-events

# Anima Webhooks & Events ## Overview Anima doesn't have its own webhooks, but you can use **Figma Webhooks** (v2 API) to detect design changes and trigger Anima code generation automatically. This creates an event-driven design-to-code pipeline. ## Instructions ### Step 1: Register Figma Webhook ```bash # Figma Webhooks API (requires team-level access) curl -X POST "https://api.figma.com/v2/webhooks" \ -H "X-Figma-Token: ${FIGMA_TOKEN}" \ -H "Content-Type: application/json" \ -d '{ "event_type": "FILE_VERSION_UPDATE", "team_id": "YOUR_TEAM_ID", "endpoint": "https://your-server.com/webhooks/figma", "passcode": "your-webhook-secret", "description": "Trigger Anima code generation on design changes" }' ``` ### Step 2: Webhook Handler ```typescript // src/webhooks/figma-handler.ts import express from 'express'; import { Anima } from '@animaapp/anima-sdk'; const router = express.Router(); const anima = new Anima({ auth: { token: process.env.ANIMA_TOKEN! } }); interface FigmaWebhookEvent { event_type: 'FILE_VERSION_UPDATE' | 'FILE_UPDATE' | 'FILE_DELETE'; file_key: string; file_name: string; triggered_by: { id: string; handle: string }; timestamp: string; passcode: string; } router.post('/webhooks/figma', express.json(), async (req, res) => { const event = req.body as FigmaWebhookEvent; // Verify passcode if (event.passcode !== process.env.FIGMA_WEBHOOK_SECRET) { return res.status(401).json({ error: 'Invalid passcode' });...