Getting started

Fri, 28 Aug 2026 00:00:00 +0000

Tapak is not on Opam yet (soon!). Until then, install it by pinning the Git repository or by using Nix.

Install with Opam

# Tapak use cows for websocket
opam pin add cows https://github.com/syaiful6/cows.git
opam pin add tapak https://github.com/syaiful6/tapak.git

# Install dependencies and build
opam install cows tapak --deps-only

Instead of pinning manually, add this to your Opam file:

pin-depends: [
 ["cows", "git+https://github.com/syaiful6/cows.git"]
 ["tapak", "git+https://github.com/syaiful6/tapak.git"]
]

Install with Nix

Add Tapak as flake input in your flake.nix:

Routing

Fri, 28 Aug 2026 00:00:00 +0000

Routes define your application’s endpoints. A Tapak handler usually does not receive Tapak.Request.t directly; it receives values extracted from the request and returns Tapak.Response.t.

Tapak’s router is type-safe, so the route definition determines the arguments that its handler must accept.

Basic routing

(** All handlers below have type [unit -> Tapak.Response.t]. *)
let routes = Tapak.Router.(
 of_list
 [ get (s "") |> unit |> into home_handler
 ; post (s "") |> unit |> into home_post_handler
 ; put (s "") |> unit |> into home_put_handler
 ; delete (s "") |> unit |> into home_delete_handler
 ; patch (s "") |> unit |> into home_patch_handler
 ]
)

The router also provides head and any. Use unit when a handler does not need any values from the request. of_list turns a list of routes into a handler and accepts an optional not_found handler.

Documentation on Syaiful Bahri

Getting started

Install with Opam

Install with Nix

Routing

Basic routing