# Deserve

> Web Framework for Deno Ecosystem

Deserve is a zero-dependency, zero-configuration HTTP framework for Deno. It provides file-based routing, composable middleware, streaming responses, and a typed Context API for building servers with maximum productivity.

## Table of Contents

- [Basic Auth Middleware](https://docs-deserve.neabyte.com/middleware/basic-auth.md): Protect routes with HTTP Basic Authentication middleware in Deserve.
- [Basic Static Serving](https://docs-deserve.neabyte.com/static-file/basic.md): Serve static files from a directory with the Deserve static handler.
- [Body Limit Middleware](https://docs-deserve.neabyte.com/middleware/body-limit.md): Limit incoming request body size to guard against oversized payloads.
- [Built for Teams](https://docs-deserve.neabyte.com/getting-started/built-for-teams.md): Patterns for organizing larger Deserve apps with middleware scoping and shared configuration for teams.
- [Context Object](https://docs-deserve.neabyte.com/core-concepts/context-object.md): The Context object passed to every handler: request access, response helpers, params, state, and cookies.
- [CORS Middleware](https://docs-deserve.neabyte.com/middleware/cors.md): Configure Cross-Origin Resource Sharing (CORS) policy for Deserve routes.
- [CSRF Middleware](https://docs-deserve.neabyte.com/middleware/csrf.md): Protect against Cross-Site Request Forgery with origin and sec-fetch-site checks.
- [Custom Responses](https://docs-deserve.neabyte.com/response/custom.md): Build fully custom responses with ctx.send.custom() when the helpers are not enough.
- [Data Download Responses](https://docs-deserve.neabyte.com/response/data.md): Send binary data downloads with ctx.send.data().
- [Default Error Behavior](https://docs-deserve.neabyte.com/error-handling/default-behavior.md): How Deserve handles uncaught errors by default and the responses it produces.
- [Defense in Depth](https://docs-deserve.neabyte.com/error-handling/defense-in-depth.md): Layered error handling in Deserve to keep services available under faults.
- [Error Object Details](https://docs-deserve.neabyte.com/error-handling/object-details.md): Customize error responses with router.catch() and the ErrorInfo object.
- [Error Reporting](https://docs-deserve.neabyte.com/middleware/observability/errors.md): Capture and report errors from Deserve using the observability event stream.
- [Event Reference](https://docs-deserve.neabyte.com/middleware/observability/events.md): Reference of all lifecycle and error events emitted by a serving Deserve router.
- [Examples](https://docs-deserve.neabyte.com/examples.md)
- [File Download Responses](https://docs-deserve.neabyte.com/response/file.md): Serve file downloads from the filesystem with ctx.send.file().
- [File-based Routing](https://docs-deserve.neabyte.com/core-concepts/file-based-routing.md): How Deserve maps the routes directory structure to HTTP endpoints using file-based routing.
- [Global Middleware](https://docs-deserve.neabyte.com/middleware/global.md): Register global middleware that runs for every request with router.use().
- [Hot Reload](https://docs-deserve.neabyte.com/core-concepts/hot-reload.md): Hot reload in Deserve: how route and template changes are detected and applied without restarting the server.
- [HTML Responses](https://docs-deserve.neabyte.com/response/html.md): Send HTML responses with ctx.send.html().
- [Installation](https://docs-deserve.neabyte.com/getting-started/installation.md): Install Deserve into a Deno project using the JSR package registry.
- [IP Restriction Middleware](https://docs-deserve.neabyte.com/middleware/ip.md): Restrict access by IP address using whitelist and blacklist rules with CIDR support.
- [JSON Responses](https://docs-deserve.neabyte.com/response/json.md): Send JSON responses with ctx.send.json(), including status codes and headers.
- [Multi-Service](https://docs-deserve.neabyte.com/core-concepts/multi-service.md): Running multiple Deserve services side by side in a single Deno process.
- [Multiple Directories](https://docs-deserve.neabyte.com/static-file/multiple.md): Serve static assets from multiple directories under different URL prefixes in Deserve.
- [Observability Overview](https://docs-deserve.neabyte.com/middleware/observability/overview.md): Overview of Deserve observability: lifecycle events, logging, and error reporting.
- [Performance and Limits](https://docs-deserve.neabyte.com/rendering/performance.md): Performance characteristics and caching behavior of the Deserve template engine.
- [Philosophy](https://docs-deserve.neabyte.com/core-concepts/philosophy.md): The design philosophy behind Deserve: convention over configuration, zero dependencies, and Deno-native ergonomics.
- [Quick Start](https://docs-deserve.neabyte.com/getting-started/quick-start.md): Build your first Deserve HTTP server and route in under five minutes.
- [Redirect Responses](https://docs-deserve.neabyte.com/response/redirect.md): Create redirect responses with ctx.send.redirect(), including allowed status codes and safety rules.
- [Rendering Overview](https://docs-deserve.neabyte.com/rendering.md): Server-side template rendering in Deserve using the built-in DVE view engine.
- [Request Handling](https://docs-deserve.neabyte.com/core-concepts/request-handling.md): How Deserve parses and handles incoming requests, including body parsing and content negotiation.
- [Request Logging](https://docs-deserve.neabyte.com/middleware/observability/logging.md): Turn Deserve request events into structured request logs.
- [Route Patterns](https://docs-deserve.neabyte.com/core-concepts/route-patterns.md): Route pattern syntax in Deserve including dynamic params, wildcards, and matching rules.
- [Route-Specific Middleware](https://docs-deserve.neabyte.com/middleware/route-specific.md): Scope middleware to a path prefix so it runs only for matching routes.
- [Routes Configuration](https://docs-deserve.neabyte.com/getting-started/routes-configuration.md): Configure the routes directory, parameter limits, and request timeouts in the Deserve Router.
- [Security Headers Middleware](https://docs-deserve.neabyte.com/middleware/security-headers.md): Apply common security response headers with the Deserve security headers middleware.
- [Server Configuration](https://docs-deserve.neabyte.com/getting-started/server-configuration.md): Configure how the Deserve server listens, shuts down gracefully, and protects the process.
- [Session Middleware](https://docs-deserve.neabyte.com/middleware/session.md): Cookie-based session middleware signed with HMAC-SHA256 for per-user state.
- [Stream Responses](https://docs-deserve.neabyte.com/response/stream.md): Send streaming responses from a ReadableStream with ctx.send.stream().
- [Streaming Template Rendering](https://docs-deserve.neabyte.com/rendering/streaming.md): Streaming template rendering in Deserve for faster time-to-first-byte responses.
- [Template Syntax](https://docs-deserve.neabyte.com/rendering/syntax.md): DVE template syntax reference: variables, conditionals, loops, and includes.
- [Text Responses](https://docs-deserve.neabyte.com/response/text.md): Send plain text responses with ctx.send.text().
- [WebSocket Middleware](https://docs-deserve.neabyte.com/middleware/websocket.md): Upgrade requests to WebSocket connections with lifecycle callbacks in Deserve.
- [Worker Pool](https://docs-deserve.neabyte.com/core-concepts/worker-pool.md): Offloading CPU-bound work to a pool of Deno workers via the Deserve worker pool API.
- [Zero Dependency](https://docs-deserve.neabyte.com/core-concepts/zero-dependency.md): Why Deserve ships with zero third-party dependencies and relies only on the Deno standard runtime.