Introduction

Taser is a modern, type-safe, file-based router designed for scalable Node.js and edge HTTP services. It bridges the gap between clean filesystem architecture and strict type safety.

Traditional Node.js routing forces you to write manual route registries, perform unsafe type assertions on req.user, and maintain separate client types that drift over time. Taser solves these challenges by treating the filesystem as the source of truth, cascading middleware state through directory layouts, and generating a 100% typed client SDK.

import { json, notFound } from "@taserjs/router/reply";
import { z } from "zod";
import { t } from "@taserjs/router";

const GET = t
  .get("/users/:id")
  .params(z.object({ id: z.string().uuid() }))
  .query(z.object({ includeProfile: z.coerce.boolean().default(false) }))
  .returns({
    200: z.object({ id: z.string(), name: z.string(), email: z.string() }),
    404: z.object({ message: z.string() }),
  });

export type RouteContext = typeof GET.$Infer.Context;
export default GET.handler(async (ctx) => {
  // ctx.params.id is typed as string (UUID)
  // ctx.query.includeProfile is typed as boolean
  // ctx.state contains data injected by layout middlewares
  const user = await ctx.db.findUserById(ctx.params.id);
  if (!user) {
    return notFound({ message: "User not found" });
  }

  return json(user);
});

Why Taser?

How Taser Works

Taser operates around a deterministic, fully type-safe request lifecycle:

// Taser receives Web Standard Request
const response = await taserApp.fetch(request);

Scaffold with create-taserjs

Get up and running in seconds using the official scaffolding CLI. Customize your stack across five modular dimensions:

• Host Framework: Standalone Taser (none), hono, express, or fastify.
• Deployment Preset: node-server, node-cluster, bun, deno-server, deno-deploy, cloudflare-module, vercel, aws-lambda, netlify, or standalone Vite (none).
• Runtime Override: Explicit node or bun execution target for self-hosted presets.
• Database & Driver: Drizzle, Prisma, or Kysely with SQLite, PostgreSQL, or MySQL drivers (--db <odm>:<driver>).
• Standard Add-ons: Zod, ArkType, or Valibot for schema validation; Pino or Winston for structured logging.

pnpm create taserjs@latest my-api

For full flag definitions and project structure options, see the Quickstart Guide.

Quick Navigation

Explore the documentation to start building or migrating your existing server: