linktree-local-dev-loop

# Linktree Local Dev Loop ## Overview Local development workflow for Linktree link-in-bio API integration. Provides a fast feedback loop with mock link profiles, analytics, and appearance data so you can build social management tools without hitting the live Linktree API. Toggle between mock mode for rapid UI iteration and live mode for validating profile updates against the real Linktree platform. ## Environment Setup ```bash cp .env.example .env # Set your credentials: # LINKTREE_API_KEY=lt_xxxxxxxxxxxx # LINKTREE_BASE_URL=https://api.linktr.ee/v1 # MOCK_MODE=true npm install express axios dotenv tsx typescript @types/node npm install -D vitest supertest @types/express ``` ## Dev Server ```typescript // src/dev/server.ts import express from "express"; import { createProxyMiddleware } from "http-proxy-middleware"; const app = express(); app.use(express.json()); const MOCK = process.env.MOCK_MODE === "true"; if (!MOCK) { app.use("/v1", createProxyMiddleware({ target: process.env.LINKTREE_BASE_URL, changeOrigin: true, headers: { Authorization: `Bearer ${process.env.LINKTREE_API_KEY}` }, })); } else { const { mountMockRoutes } = require("./mocks"); mountMockRoutes(app); } app.listen(3005, () => console.log(`Linktree dev server on :3005 [mock=${MOCK}]`)); ``` ## Mock Mode ```typescript // src/dev/mocks.ts — realistic link-in-bio profile and analytics responses export function mountMockRoutes(app: any) { app.get("/v1/profile", (_req: any, res: any) => re...