Introducing vercel.ts: Programmatic project configuration

Vercel now supports vercel.ts, a new TypeScript-based configuration file that brings type safety, dynamic logic, and better developer experience to project configuration.

vercel.ts lets you express configuration as code by defining advanced routing, request transforms, caching rules, and cron jobs, going beyond what static JSON can express. In addition to full type safety, this also allows access to environment variables, shared logic, and conditional behavior.

All projects can now use vercel.ts (or .js, .mjs, .cjs, .mts) for project configuration. Properties are defined identically to vercel.json and can be enhanced using the new @vercel/config package.

1
import { type VercelConfig, routes, deploymentEnv } from '@vercel/config/v1';
2

3
export const config: VercelConfig = {
4
  framework: 'nextjs',
5

6
  crons: [
7
    { path: '/api/cleanup', schedule: '0 0 * * *' },
8
    { path: '/api/sync-users', schedule: '*/15 * * * *' },
9
  ],
10

11
  rewrites: [
12
    routes.rewrite('/(.*)', 'https://external-api.com', {
13
      requestHeaders: {
14
        'proxy-header': deploymentEnv('PROXY_HEADER')
15
      }
16
    }),
17
  ],
18
};

Try the playground to explore vercel.ts, learn how to migrate from an existing vercel.json, or read the documentation and the @vercel/config package.