Express Integration

Taser integrates with Express applications using the Host Pass-Through Architecture. You can keep your existing Express routes, controllers, and middleware active while writing all new endpoints with Taser's type-safe file conventions.

How It Works

1. Taser First: Taser evaluates requests against your src/routes/ directory.
2. Express Fall-Through: If no Taser route matches, the request automatically falls through to your Express application.
3. 404 Handling: If neither Taser nor Express handles the request, Taser returns a standard 404 response.

[Incoming Request]
       │
       ▼
[Taser File Routes] ── Match? ──► [Execute Taser Handler]
       │ (No match)
       ▼
[Express Host App] ─── Match? ──► [Execute Express Route / Middleware]
       │ (No match)
       ▼
[404 Not Found]

Quickstart

pnpm create taserjs@latest my-express-app --framework express -y

import express from "express";

const app = express();

// Standard Express middleware:
app.use(express.json());

// Legacy or host Express routes:
app.get("/express-legacy", (req, res) => {
  res.json({ message: "Hello from legacy Express route!" });
});

export default app;

import { json } from "@taserjs/router/reply";
import { t } from "@taserjs/router";

const GET = t.get("/users");

export default GET.handler(() => {
  return json({ users: [{ id: "1", name: "Alice" }] });
});

pnpm dev

Incremental Migration Strategy

When migrating a large Express codebase to Taser:

1. Move shared database pools and Redis clients into src/context.ts.
2. Move authentication middleware into root layout src/routes/$.ts.
3. Incrementally port controllers into verb files inside src/routes/.
4. Keep complex legacy routes in src/server.node.ts until ready to migrate.

Next Steps