Installation

Create new project

Use the create zelavis command to scaffold a new project with everything configured:

pnpm create zelavis@latest

npm create zelavis@latest

bunx create-zelavis@latest

The setup wizard will ask for your project name, preferred framework, and deployment target.

Add to existing framework

Use zelavis bootstrap to add Zelavis endpoints to an existing app.

The command is interactive by default. Use --yes with explicit flags for non-interactive setup:

pnpm dlx @zelavis/cli bootstrap --help

React Router

pnpm dlx @zelavis/cli bootstrap react-router

Generates:

app/lib/zelavis.server.ts
app/routes/zelavis.$.ts

Next.js App Router

pnpm dlx @zelavis/cli bootstrap nextjs --router app

Generates:

lib/zelavis.server.ts
app/zelavis/[[...path]]/route.ts

Next.js Pages Router

pnpm dlx @zelavis/cli bootstrap nextjs --router pages

Generates:

lib/zelavis.ts
pages/api/zelavis/[[...path]].ts
next.config.ts

Adapter selection

Each bootstrap command asks which environment the app will run on. Pass --adapter to skip the prompt:

pnpm dlx @zelavis/cli bootstrap react-router --adapter node --yes
pnpm dlx @zelavis/cli bootstrap nextjs --router app --adapter node --yes

Supported adapters: node, bun.

See the CLI docs for the full command reference.