Home

Auton8

A self-hosted business automation platform: model a process, define the data it works on, and give people the screens to work it.

This wiki is the codebase map — the orientation material that would otherwise have to be reconstructed by reading the tree. It is written for someone about to change the code, so it prefers file paths over descriptions and states the dominant pattern rather than surveying every variation.

For what the product is, how to run it, and how to contribute, start at the repository README.

The map

Page	Answers
Stack	Languages, frameworks, versions, configuration keys, how to build and run
Integrations	External services, environment variables, what talks to what
Architecture	Components and boundaries, data flow, the key abstractions
Structure	The directory map — "where do I put this?"
Conventions	Naming, patterns, error handling, state management, with real excerpts
Testing	How the suites are organised, what each covers, how to run them
Concerns	Tech debt, fragile areas, and design concerns — see the caveat below

Two things to know before trusting a page

These pages are a snapshot, not a live view. Each carries a provenance banner naming the commit it was generated from. Much of what they describe has since changed — most of the issues Concerns cites have been fixed and closed. Read them for the shape of the system; read the issue register for what is actually open.

Issue numbers here may be stale. The project moved repositories on 2026-09-02, and numbers were not preserved. References to the old register are written archived-N and can be looked up in docs/history/. A bare #N means an issue in the current repository.

Elsewhere

• Development — local stack, daily workflow, first administrator, running the tests
• Deployment — required overrides, TLS, runtime storage, pre-deployment checklist
• Contributing — how work is planned here, and what a good change looks like
• Security — report vulnerabilities privately, never as a public issue