Quickstart

You will install Zever, scaffold a project, and serve a working GET /hello endpoint. It takes about five minutes. You need Go 1.27+ and the zever CLI (installation).

Linux

curl -fsSL https://raw.githubusercontent.com/zenta-dev/zever/main/install.sh | sh

macOS

curl -fsSL https://raw.githubusercontent.com/zenta-dev/zever/main/install.sh | sh

Windows

irm https://raw.githubusercontent.com/zenta-dev/zever/main/install.ps1 | iex

Then check it with zever --version.

Scaffold the project

zever new hello
cd hello

zever new writes the minimal tree: schema/app.zen, cmd/server/main.go, internal/app/wiring.go, the sample internal/service/hello module, .env, .env.example, .gitignore, and a README.md. It also runs go mod tidy, so the project builds as-is.

Expected output (abridged):

✔ scaffolded "hello" into hello
  wrote hello/internal/app/wiring.go
  wrote hello/cmd/server/main.go
  wrote hello/internal/service/hello/service.go

The battery picker adds more services: zever new hello --with cache,queue=redis,auth (or --interactive for the prompt). --with takes a comma-separated list of batteries with optional adapter pins. See Customizing and leaving zever for the “batteries you actually need” table with measured dependency footprints.

Serve it

Run the watcher. It compiles, starts the server on :8080, and restarts on schema or source changes:

zever dev

{"time":"...","level":"INFO","msg":"http server listening","addr":":8080"}

zever serve runs the same server without watching. In a second terminal, call the sample endpoint:

curl -i localhost:8080/hello

HTTP/1.1 200 OK
Content-Type: application/json

{"hello":"world"}

The sample module registers GET /hello and resolves the logger from the container. GET /healthz always returns 200, and GET /readyz returns 200 once the database ping succeeds.

What you built

zever new scaffolds a typed wiring file, not a config file. internal/app/wiring.go declares one Ref per service and one container.Provide entry per instance, and cmd/server/main.go hands those providers plus the modules to serve.Main. Adding a battery later is one command:

zever add cache/redis
zever add db --name analytics

Next steps

Build a booking APIA full service with auth, queue, and worker.

How Zever worksSchema, compiler, container, adapters in one page.

Project layoutWhere every package lives.

CLI referenceEvery command and flag.