Getting Started

Quickstart

Deploy your first edge function and verify regional latency.

Server racks in a data center — Photo by Taylor Vick on Unsplash.

Relay Edge is a fictional edge runtime for low-latency APIs. Deploy handlers close to users, fan out webhooks globally, and observe every request with structured traces.

Latency note

This quickstart targets the eu-west and us-east regions. Cold starts under 50ms are typical after the first warm invocation.

Deploy a hello handler

bashExample

relay init hello-edge
cd hello-edge
relay deploy --region us-east

tssrc/index.ts

export default {
  async fetch(request) {
    return Response.json({ ok: true, region: Relay.region });
  },
};

Install the Relay CLI and authenticate your workspace.
Scaffold a function and deploy to one region.
Hit the generated URL and inspect the request log.

book

Architecture

How requests route across PoPs.

api

Authentication

Auth models for humans and machines.

folder

Webhooks

Signed events from the edge.

Architecture overview

CLI setup