> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goakt.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Development Setup

> Clone, build, and run tests.

## Clone and prepare

```bash theme={"theme":{"light":"github-light","dark":"dracula"}}
git clone https://github.com/your-username/goakt.git
cd goakt
```

## Build and test

Developer tooling runs inside Docker via the `Makefile`, so you only need Docker and `make`:

```bash theme={"theme":{"light":"github-light","dark":"dracula"}}
make image   # build the tools image (once)
make test    # run lint + full test suite
```

Run `make help` to see every target (`vendor`, `mock`, `protogen`, `certs`, `lint`, `unit-test`, `clean`).

## Local Go commands

You can also use standard Go commands if you have Go installed:

```bash theme={"theme":{"light":"github-light","dark":"dracula"}}
go build ./...
go test ./...
```

Tests that require infrastructure (Consul, etcd) use testcontainers and need Docker.