appfolio-local-dev-loop

# AppFolio Local Dev Loop ## Overview Local development workflow for AppFolio property management API integration. Provides a fast feedback loop with mock property, tenant, and lease endpoints so you can build and test integrations without consuming live API quota. Toggle between mock mode for rapid iteration and sandbox mode for pre-deployment validation against the real AppFolio Stack API. ## Environment Setup ```bash cp .env.example .env # Set your credentials: # APPFOLIO_API_KEY=af_live_xxxxxxxxxxxx # APPFOLIO_BASE_URL=https://api.appfolio.com/api/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("/api/v1", createProxyMiddleware({ target: process.env.APPFOLIO_BASE_URL, changeOrigin: true, headers: { Authorization: `Bearer ${process.env.APPFOLIO_API_KEY}` }, })); } else { const { mountMockRoutes } = require("./mocks"); mountMockRoutes(app); } app.listen(3001, () => console.log(`AppFolio dev server on :3001 [mock=${MOCK}]`)); ``` ## Mock Mode ```typescript // src/dev/mocks.ts — realistic property management responses export function mountMockRoutes(app: any) { app.get("/api/v1/properties", (_req: any, res: any) => ...