vercel-services

name	vercel-services
description	Vercel Services — deploy multiple services within a single Vercel project. Use for monorepo layouts or when combining a backend (Python, Go) with a frontend (Next.js, Vite) in one deployment.
summary	Deploy multiple services in one Vercel project — e.g. a Python backend alongside a JS frontend
metadata	{"priority":7,"docs":["https://vercel.com/docs/services"],"sitemap":"https://vercel.com/sitemap/docs.xml","pathPatterns":["backend/**","backend/main.py","backend/main.go","backend/go.mod","backend/pyproject.toml","backend/requirements.txt","frontend/**","apps/*/backend/**","apps/*/frontend/**","services/*/vercel.json","*/pyproject.toml","*/go.mod"],"bashPatterns":["\\bvercel\\s+dev\\b.*-L","\\bpip\\s+install\\b.*fastapi","\\buv\\s+(sync|pip|run)\\b","\\bgo\\s+(run|build|mod)\\b","\\bpython\\s+-m\\s+uvicorn\\b","\\buvicorn\\b"],"importPatterns":["fastapi"],"promptSignals":{"phrases":["services api","vercel services","multi-service","python backend","go backend","fastapi","deploy backend","backend and frontend","multiple services"],"allOf":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"],"anyOf":["backend","monorepo","service","python","golang"],"noneOf":["turborepo cache","turbo.json","aws lambda","docker compose"],"minScore":6}}
validate	[{"pattern":"@app\\.(get|post|put|delete|patch)\\s*\\(\\s*['\"]\\/api\\/","message":"Do not include routePrefix in backend routes — Vercel strips the prefix before forwarding. Use @app.get(\"/health\") not @app.get(\"/api/health\")","severity":"error"},{"pattern":"http\\.HandleFunc\\s*\\(\\s*['\"]\\/api\\/","message":"Do not include routePrefix in Go handlers — Vercel strips the prefix. Use \"/health\" not \"/api/health\"","severity":"error"}]
retrieval	{"aliases":["multi-service","backend service","services api","monorepo deploy","monorepo services"],"intents":["deploy backend and frontend together on vercel","set up python backend alongside next.js frontend","configure multi-service vercel project","add go backend to vercel project"],"entities":["experimentalServices","routePrefix","entrypoint","Services API","vercel.json services"],"examples":["deploy a fastapi backend with a react frontend","add a go api service to my vercel project","set up a multi-service monorepo on vercel"]}

Deploy multi-service projects with Vercel

Services let you deploy multiple independently-built units within a single Vercel project. The typical use case is combining different runtimes (e.g. Python + JavaScript) in one deployment with shared routing and environment variables, but services work for any combination — multiple services of the same runtime, different frameworks, or a mix.

This skill covers project structure and configuration. For the actual deployment, defer to the deployments-cicd skill.

How It Works

A service is an independently built unit within your project, deployed to the same domain under a unique subpath. At build time, Vercel builds each service separately. At request time, Vercel routes incoming requests to the correct service based on the URL path prefix (longest prefix wins).

• Services are enabled via the experimentalServices field in vercel.json (see reference project).
• vercel dev -L auto-detects frameworks and runs all services locally as one application, handling routing automatically. The -L flag (short for --local) runs without authenticating with Vercel Cloud.
• Only vercel.json lives at the root. Each service manages its own dependencies independently.

Configuration

Define services in vercel.json:

{
  "experimentalServices": {
    "web": {
      "entrypoint": "apps/web",
      "routePrefix": "/"
    },
    "api": {
      "entrypoint": "backend/main.py",
      "routePrefix":