diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 95531eec..c9c25d6b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -158,10 +158,12 @@ Meridian is a pnpm monorepo managed with Turborepo:
 meridian/
   apps/
     web/        -- Vite + React frontend (Freighter wallet, yield dashboard)
-    api/        -- Fastify API (yield aggregation, Soroban tx building)
+    api-local/  -- Fastify API, local dev only (yield aggregation, Soroban tx building)
     docs/       -- Documentation site
     landing/    -- Landing page
+  api/          -- Vercel serverless functions (api/v1/...), the production API
   packages/
+    api-core/   -- Framework-agnostic route handlers shared by both servers
     contracts/  -- Soroban smart contracts (Rust)
     shared/     -- Shared utilities used by both api and web
     stellar-sdk-helpers/ -- Typed wrappers around @stellar/stellar-sdk
diff --git a/README.md b/README.md
index c50b3181..2c310a00 100644
--- a/README.md
+++ b/README.md
@@ -43,10 +43,12 @@ Inflation in many West African economies regularly exceeds 20 % annually. Access
 meridian/
 ├── apps/
 │   ├── web/          # Vite + React 19 dashboard (TypeScript, Tailwind, Zustand)
-│   ├── api/          # Fastify REST API (local dev): builds Soroban txs, aggregates APY
+│   ├── api-local/    # Fastify REST API (local dev only): builds Soroban txs, aggregates APY
 │   ├── docs/         # Internal architecture and operations docs
 │   └── landing/      # Marketing landing page
+├── api/              # Vercel serverless functions (api/v1/...) — the production API
 ├── packages/
+│   ├── api-core/             # Framework-agnostic route handlers shared by both servers
 │   ├── stellar-sdk-helpers/  # Blend & DeFindex client wrappers
 │   ├── shared/               # Zod schemas, constants, pure utils
 │   └── contracts/            # Soroban smart contracts (Rust): vault, blend-adapter, defindex-adapter
diff --git a/apps/docs/operations/local-development.md b/apps/docs/operations/local-development.md
index 977e0113..d944110a 100644
--- a/apps/docs/operations/local-development.md
+++ b/apps/docs/operations/local-development.md
@@ -40,7 +40,7 @@ The Vite dev server proxies `/api/*` to `http://localhost:3001` and `/docs/*` to
 pnpm --filter @meridian/web dev
 
 # API only
-pnpm --filter @meridian/api dev
+pnpm --filter @meridian/api-local dev
 ```
 
 ## Health check