Routes Configuration

Configure Deserve routes directory to match your project structure.

Router Options

The Router constructor accepts configuration options. Main options: routesDir (directory for route files), requestTimeoutMs (request timeout), and optional errorResponseBuilder / staticHandler.

// 1. Import Router
import { Router } from '@neabyte/deserve'

// 2. Set custom routesDir and optional request timeout (default: ./routes, no timeout)
const router = new Router({
  routesDir: 'src/routes',
  requestTimeoutMs: 30_000
})

Configuration Options

routesDir

The directory containing your route files:

// 1. Default: routes from ./routes
const router = new Router()

// 2. Custom: routes from ./src/api
const router = new Router({
  routesDir: 'src/api'
})

requestTimeoutMs

Optional timeout in milliseconds for the full request (middleware + route handler). If exceeded, the server responds with 503 Service Unavailable. Omit or leave undefined for no timeout.

const router = new Router({
  routesDir: 'routes',
  requestTimeoutMs: 30_000
})

Supported File Extensions

Deserve automatically detects and supports these file extensions:

• .ts (TypeScript)
• .js (JavaScript)
• .tsx (TypeScript with JSX)
• .jsx (JavaScript with JSX)
• .mjs (ES Modules)
• .cjs (CommonJS)

You don't need to configure extensions - Deserve automatically detects them.

Absolute vs Relative Paths

Relative Paths

const router = new Router({
  routesDir: 'routes'
})

Absolute Paths

const router = new Router({
  routesDir: `${Deno.cwd()}/routes`
})

const router = new Router({
  routesDir: '/absolute/path/to/routes'
})