Installation

Prerequisites

Zig 0.16.0 or later — Install Zig
Git — for fetching dependencies via build.zig.zon

Install the CLI

The zzz CLI provides project scaffolding, code generation, a dev server, and database migrations.

curl -fsSL https://zzz.seemsindie.com/install.sh | sh

Install a specific version:

ZZZ_VERSION=v0.1.0 curl -fsSL https://zzz.seemsindie.com/install.sh | sh

git clone https://github.com/seemsindie/zzz_cli.git
cd zzz_cli
zig build
# Binary at zig-out/bin/zzz

Verify the installation:

zzz version

Create a new project

Scaffold the project

zzz new my_app

This creates a full project structure:

my_app/
  build.zig
  build.zig.zon
  .gitignore
  src/
    main.zig
    controllers/
  templates/
  public/
    css/style.css
    js/app.js

Build and run
Terminal window
```
cd my_app
zig build run
```
Your server is now running at http://127.0.0.1:4000.
Start the dev server (with auto-reload)
Terminal window
```
zzz server
```

Add to an existing project

If you already have a Zig project and want to add zzz as a dependency:

Add the dependency to your build.zig.zon:

.dependencies = .{
    .zzz = .{
        .url = "https://github.com/seemsindie/zzz.zig/archive/refs/tags/v0.1.0.tar.gz",
        .hash = "...", // zig build will tell you the expected hash
    },
},

Wire it up in build.zig:

const zzz_dep = b.dependency("zzz", .{
    .target = target,
    .optimize = optimize,
});

exe.root_module.addImport("zzz", zzz_dep.module("zzz"));

Import and use:

const zzz = @import("zzz");

Optional dependencies

Package	What it adds	How to enable
zzz_db	Database (SQLite & PostgreSQL)	Add `zzz_db` dependency
zzz_jobs	Background job processing	Add `zzz_jobs` dependency
zzz_mailer	Email sending	Add `zzz_mailer` dependency
zzz_template	Template engine	Add `zzz_template` dependency

Next steps

Follow the Quick Start tutorial
Learn about Project Structure
Explore Routing and Middleware