Getting Started
OverviewLanguage GuideFull Reference
Book
Table of ContentsIntroductionPrefaceGetting StartedLanguage TourOwnershipErrorsConcurrencyStdlibNetworkingDataPackagesSpeed & SafetyCross-PlatformToolingCookbookAppendix
Reference
Standard LibraryKeywordsPerformanceSecurityBuilt-in FunctionsStatusDebuggingABI
How-To
Getting StartedHTTP APIsErrorsPackagesConcurrencyMemoryWASITestingRelease Builds
Project
RoadmapVisionChangelogContributing

How-To Guides

Practical, hands-on tutorials for building with Mako. Each guide includes working code you can run immediately.

Guides

# Guide What you will build / learn
01 Getting Started Install Mako, create a project, build and run your first program
02 HTTP APIs Build a JSON API server with routing, request parsing, and a client
03 Errors and Debugging Handle errors with Result and ?, wrap context, debug with dbg and lldb
04 Packages Create reusable packages, manage dependencies, set up workspaces
05 Concurrency Use crew blocks, channels, select, fan, and actors for parallel work
06 Memory Understand ownership with hold/share, use arenas, choose the right strategy
07 WASI Compile to WebAssembly, run with wasmtime, pass args and access files
08 Testing Write tests, run them, filter by name, measure coverage, use subtests
09 Release Builds Optimize binaries, cross-compile, static link, package for deployment

Prerequisites

All guides assume you have Mako installed (mako version prints output). Guide 01 covers installation from scratch.

Edit this page on GitHub Report an issue