# Developer guide

How Zinc is built, tested and released.

- [Architecture](https://aborakati.github.io/zinc/developer-guide/architecture.md): the pieces, the ports, and how they talk
- [Building from source](https://aborakati.github.io/zinc/developer-guide/building.md), including [Linux and macOS](https://aborakati.github.io/zinc/developer-guide/building.md#linux-and-macos)
- [Testing](https://aborakati.github.io/zinc/developer-guide/testing.md): `bun test`, fuzzing, headless screenshots, CI
- [Database and migrations](https://aborakati.github.io/zinc/developer-guide/database.md), including how to add a migration
- [The core HTTP API](https://aborakati.github.io/zinc/developer-guide/http-api.md)
- [The translators runtime](https://aborakati.github.io/zinc/developer-guide/translators.md)
- [Releasing](https://aborakati.github.io/zinc/developer-guide/releasing.md): installer, update feed, signing hooks, AppImage and disk image
- [Releasing the browser extension](https://aborakati.github.io/zinc/developer-guide/extension-release.md): the connector's two zips, the workflow, store updates
- [WASM plugins](https://aborakati.github.io/zinc/developer-guide/wasm-plugins.md): the plugin system's design, [writing a plugin](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/writing-a-plugin.md), and [agent skills for plugin authors](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/agent-skills.md)
- [Contributing](https://aborakati.github.io/zinc/developer-guide/contributing.md)

The repository root keeps `CONTRIBUTING.md` (GitHub links to it from pull requests). It holds the short version and points here.
