API Mock from OpenAPI

cd apps/experiments/api-mock-from-openapi
pnpm install
pnpm dev

API Mock from OpenAPI turns an OpenAPI YAML/JSON snippet into Next.js App Router Route Handler stubs via generateObject. The UI lists method/path mappings and downloads a concatenated stubs file. No AI keys - 503.

FeaturesCopy Anchor Link

• OpenAPI paste – YAML or JSON sample products API.
• Route list – method, path, handler filename.
• Download stubs – single text file of mock handlers.
• Cap 12 operations.
• Honest unavailable state.

Server ReferenceCopy Anchor Link

POST /api/mockCopy Anchor Link

{ "openapi": "openapi: 3.0.3\n..." }

Success (200)Copy Anchor Link

{
  "summary": "Mocks for Products API list/create/get.",
  "routes": [
    {
      "method": "GET",
      "path": "/api/products",
      "handlerFilename": "app/api/products/route.ts",
      "stubSource": "export async function GET() { ... }"
    }
  ],
  "downloadText": "// GET /api/products\n...",
  "provider": "ai-gateway"
}

Implementation DetailsCopy Anchor Link

clampBundle rebuilds downloadText if the model leaves it empty.

Use CasesCopy Anchor Link

• Bootstrap mock handlers from a spec.
• Teach OpenAPI - App Router mapping.
• Offline API demos.

LimitationsCopy Anchor Link

• Stubs are not type-checked or wired into the app.
• Complex $ref graphs may be incomplete.
• No auth / rate limits.

Use in your projectCopy Anchor Link

Copy the download helper and stub schema; paste files into app/api manually after review.

DeploymentCopy Anchor Link

Deploy on Vercel

Local DevelopmentCopy Anchor Link

cd apps/experiments/api-mock-from-openapi
pnpm install
pnpm dev

ConfigurationCopy Anchor Link

Vercel / Next.js Features UsedCopy Anchor Link

• AI SDK generateObject
• Vercel AI Gateway
• Route Handlers
• Zod

Next StepsCopy Anchor Link