1 of 1

Overview

Azu is a high-performance web framework for Crystal emphasizing type safety, modularity, and real-time capabilities.

Quick Example

Architecture

Endpoints are type-safe handlers with:

Request Contract: Validates and types incoming data
Response Object: Handles content rendering
Middleware: Cross-cutting concerns (auth, logging, etc.)

Core Features

Feature

Description

Documentation

New to Azu?

Need to do something?

Looking for API?

Want to understand?

Tutorials

Step-by-step lessons to learn Azu:

- Install and create your first app
- Complete CRUD API tutorial
- Real-time features

How-To Guides

Task-oriented guides for specific goals:

- Create endpoints, handle parameters, return formats
- Validate requests and models
- WebSocket channels and live components

Reference

Technical specifications and API documentation:

- Endpoint, Request, Response, Channel, Component
- Built-in middleware handlers
- All configuration options

Explanation

Conceptual understanding of Azu:

- How Azu works
- Request flow
- Compile-time guarantees

Resources

- Common questions and troubleshooting
- Development setup and guidelines

Overview

Azu is a high-performance web framework for Crystal emphasizing type safety, modularity, and real-time capabilities.

Quick Example

require "azu"

module MyApp
  include Azu

  configure do
    port = 3000
  end
end

struct HelloRequest
  include Azu::Request
  getter name : String = "World"
end

struct HelloResponse
  include Azu::Response
  def initialize(@name : String); end
  def render
    "Hello, #{@name}!"
  end
end

struct HelloEndpoint
  include Azu::Endpoint(HelloRequest, HelloResponse)
  get "/"
  def call : HelloResponse
    HelloResponse.new(hello_request.name)
  end
end

MyApp.start [
  Azu::Handler::Logger.new,
  Azu::Handler::Rescuer.new
]

Architecture

HTTP Request → Router → Middleware Chain → Endpoint → Response
                                              ↓
                                    Request Contract (validation)

Endpoints are type-safe handlers with:

Request Contract: Validates and types incoming data
Response Object: Handles content rendering
Middleware: Cross-cutting concerns (auth, logging, etc.)

Core Features

Feature

Description

Documentation

New to Azu?

Need to do something?

Looking for API?

Want to understand?

Tutorials

Step-by-step lessons to learn Azu:

- Install and create your first app
- Complete CRUD API tutorial
- Real-time features

How-To Guides

Task-oriented guides for specific goals:

- Create endpoints, handle parameters, return formats
- Validate requests and models
- WebSocket channels and live components

Reference

Technical specifications and API documentation:

- Endpoint, Request, Response, Channel, Component
- Built-in middleware handlers
- All configuration options

Explanation

Conceptual understanding of Azu:

- How Azu works
- Request flow
- Compile-time guarantees

Resources

- Common questions and troubleshooting
- Development setup and guidelines

require "azu"

module MyApp
  include Azu

  configure do
    port = 3000
  end
end

struct HelloRequest
  include Azu::Request
  getter name : String = "World"
end

struct HelloResponse
  include Azu::Response
  def initialize(@name : String); end
  def render
    "Hello, #{@name}!"
  end
end

struct HelloEndpoint
  include Azu::Endpoint(HelloRequest, HelloResponse)
  get "/"
  def call : HelloResponse
    HelloResponse.new(hello_request.name)
  end
end

MyApp.start [
  Azu::Handler::Logger.new,
  Azu::Handler::Rescuer.new
]

Overview

hashtagQuick Example

hashtagArchitecture

hashtagCore Features

hashtagDocumentation

hashtagTutorials

hashtagHow-To Guides

hashtagReference

hashtagExplanation

hashtagResources

Overview

hashtagQuick Example

hashtagArchitecture

hashtagCore Features

hashtagDocumentation

hashtagTutorials

hashtagHow-To Guides

hashtagReference

hashtagExplanation

hashtagResources

Quick Example

Architecture

Core Features

Documentation

Tutorials

How-To Guides

Reference

Explanation

Resources

Quick Example

Architecture

Core Features

Documentation

Tutorials

How-To Guides

Reference

Explanation

Resources