# Developer Guide

This guide covers essential workflows for developing and contributing to
Minitrino, including building modules, testing, and understanding the CI/CD
pipeline.

## Topics

**[Build a Module](build-a-module)** - Step-by-step guide to creating new
modules for catalogs, security, or administrative features. Learn about the
module structure, Docker Compose configuration, metadata files, and proper
labeling conventions.

**[CLI and Library Tests](cli-and-library-tests)** - Overview of Minitrino's
testing architecture, including pytest-based CLI tests (integration and unit)
and JSON-driven library tests. Includes instructions for running tests locally.

**[GitHub Workflows](github-workflows)** - Understanding the automated CI/CD
workflows that handle version management, testing, and releases. Learn about
release branch conventions and the automated release process.

```{toctree}
---
hidden:
---
build-a-module
cli-and-library-tests
github-workflows
```

______________________________________________________________________

[Minitrino GitHub repository](https://github.com/jefflester/minitrino).