tyex 🚀

Type-safe Express.js routes with automatic OpenAPI documentation generation. Zero config, zero hassle.

Why tyex?

• ✨ Full Type Safety: Leverage TypeScript's type system for your Express routes
• 📚 Automatic OpenAPI: Generate OpenAPI documentation directly from your route definitions
• 🛡️ Runtime Validation: Uses AJV for runtime type checking
• 🔌 Express Compatible: Drop-in replacement for Express Router
• 🪶 Lightweight: Minimal overhead, maximum value

Quick Start

import { Type } from "@sinclair/typebox";
import tyex from "tyex";

const app = tyex();

// Serve OpenAPI documentation
app.express.use(
  "/openapi.json",
  app.openapi({
    info: {
      title: "My API",
      version: "1.0.0",
    },
  }),
);

// Define your route with types and documentation in one place
app.get(
  "/hello",
  {
    summary: "Say hello",
    responses: {
      200: {
        description: "Success",
        content: {
          "application/json": {
            schema: Type.Object({
              message: Type.String(),
            }),
          },
        },
      },
    },
  },
  (req, res) => {
    res.json({ message: "Hello, World!" });
  },
);

Installation

npm install tyex

Examples

Check out our example project for a complete CRUD API implementation.

Contributing

PRs are welcome! For major changes, please open an issue first to discuss what you would like to change.

License

MIT