We welcome contributions—bug fixes, features, and documentation improvements. This section helps collaborators get started.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.
Prerequisites
- Docker
make(pre-installed on macOS and most Linux distributions)
buf, mockery, golangci-lint, openssl) runs inside a Docker image built by the Makefile. No additional local installs are required.
Before you start
- Read the Architecture Document to understand the codebase
- Check existing issues and discussions
- Follow Conventional Commits for commit messages
How to contribute
- Fork the repository
- Create a branch for your change
- Make your changes; ensure tests pass:
make test - Commit with a conventional commit message
- Open a pull request to the
mainbranch - For bug fixes, leave a working sample in the
playgroundpackage per its instructions
Key documents
- Development Setup — Clone, build, run tests
- Testing Strategy — TestKit, mocks, integration tests
- Extending GoAkt — Adding discovery, mailboxes, extensions