Baz / Guides
Guides & recipes
Choose a guide by what you want to do: build an application, send live updates, or understand its capacity.
Looking up a type or function? Open the generated API reference →
Build an application
Application APICompose an App and handle requests and responses, with notes for Zap users.
Application recipesBind to the LAN, download runtime files, decode fields, and customize errors.
Runnable examplesChoose a small example and run it locally.
Mustache templatesRender HTML from startup-owned templates and typed data.
Cookies, redirects, and sessionsRead cookies, choose expiry and scope, and manage session lifetimes.
Middleware and request localsShare authentication and other request work through ordered hooks.
Send live updates
Streaming responsesWrite and flush a response incrementally through a standard Zig writer.
Typed continuationsKeep many streams waiting while releasing the executor between steps.
Server-sent events and notificationsEncode events and wake waiting requests with bounded messages.
A complete live-job applicationPut templates, authentication, background jobs, and live progress together.
Understand capacity
Limits and backpressureUnderstand connection admission, worker capacity, slow readers, and rejection.
Connection-limit walkthrough: two slots, three clientsFill the slots yourself, observe rejection, and release a slot to recover.
Pipelining and browser downloadsUnderstand ordered HTTP/1.1 requests and parallel asset downloads.
Ownership contractKnow how long borrowed input, response storage, and application state remain valid.
Go deeper
Packages and embeddingUnderstand the framework and engine boundary and consume Baz as a package.
Module contractsFind the responsibilities and interfaces of Baz's modules.
Engine referenceFind the engine's source, architecture, and ownership contracts.
The std.Io decisionRead the reasoning behind caller-supplied I/O and fixed workers.
API design and predecessor analysisExplore the design rationale and the original implementation plan.
Roadmap and implementation ledgerFollow milestones, verification gates, and recorded implementation work.
Evidence and verificationFind source inputs and native integration receipts.
Repository history and publicationUnderstand the standalone repository, branches, and CI.
Website maintenanceBuild, preview, check, and publish this documentation site.
Mustache selectionRead the comparison behind the template dependency choice.
Streaming across three platformsInspect the recorded Windows, Linux, and macOS verification.
bounded/httpRead the engine's engineering paper and documentation.