# Contribute

This shelf is for contributors: how to build Bookclerk, how CI checks a
change, and how to write code documentation and docs pages. The
conventions every change follows are in
[`AGENTS.md`](https://github.com/Bookclerk/bookclerk/blob/main/AGENTS.md) at the root of the repository.

## Pages on this shelf

- [Build from source and use the CLI](/docs/contributing/build-from-source/index.md): build the
  binaries and drive Bookclerk from the command line.
- [Dev Container](/docs/contributing/devcontainer/index.md): a ready-made build environment.
- [Web UI development](/docs/contributing/ui/index.md): the React app, the tray, brand
  assets, and the UI library reference.
- [Visual and accessibility testing](/docs/contributing/ui/visual-testing/index.md): Storybook
  stories, website and collector pages, axe-core checks and screenshot
  baselines in CI.
- [Continuous integration](/docs/contributing/ci/index.md): the planner, the jobs and `CI Gate`.
- [Fuzzing](/docs/contributing/fuzzing/index.md): fuzz targets in CI and crash triage.
- [Repository automation](/docs/contributing/automation/index.md): dependency updates, advisories,
  docs publishing and Worker deploys.
- [Release packaging](/docs/contributing/packaging/index.md): platform bundles and release CI.
- [Code documentation](/docs/contributing/code-documentation/index.md): how to document Rust,
  TypeScript, Python and shell.
- [Writing docs](/docs/contributing/writing-docs/index.md): how to write a docs page people can
  read quickly.
- [Licensing and the CLA](/docs/contributing/licensing/index.md): which license covers what, the
  contributor agreement and the trademark policy.
- [Research notes](/docs/contributing/research/index.md): store candidates and Libation
  parity.

## Next steps

- [How it works](/docs/internals/index.md): the architecture behind the
  code you are changing.
- [Design decisions](/docs/adr/index.md): the records a change may need to
  update.
