1.1Introduction

Relay is an API toolkit for small teams. You write route handlers as plain functions, and Relay handles hosting, environments, secrets, logs, and webhooks. There is no server to manage and no YAML to learn.

#The mental model

A Relay project is a folder of routes plus one config file:

my-api/
├── relay.toml
└── routes/
    ├── users.ts        →  /users
    ├── users/[id].ts   →  /users/:id
    └── health.ts       →  /health

Each file exports a handler. Deploying uploads the folder, builds it, and atomically swaps traffic to the new build:

// routes/health.ts
export default function handler() {
  return Response.json({ ok: true });
}

#What Relay gives you

#Where to go next

• Installation gets the CLI on your machine.
• Quickstart deploys your first route in about a minute.
• The changelog tracks everything that ships.