Next.js App Router Patterns

Route Handlers (API Routes)

Create API endpoints in app/api/[resource]/route.ts:

// app/api/incidents/route.ts
import { NextRequest } from 'next/server';
import { z } from 'zod';

const QuerySchema = z.object({
  bbox: z.string().optional(),
  category: z.string().optional(),
  severity: z.string().optional(),
  since: z.string().datetime().optional(),
  limit: z.coerce.number().min(1).max(500).default(100),
});