Guides help you understand the platform and get work done with it. They teach; the Conventions recommend, and the Values and Decisions explain why. Contributors to the toolkit itself have their own rules.

Architectural blueprint lines on a dark background with red-orange highlights, wide banner

Not sure where to start? The adoption advisor asks a few questions about your project and suggests packages, steps and pages, in order.

Onboarding: read in this order

Guide Answers
1. How the Platform Fits Together What are the pieces, what is mine, how does a request or a job travel through them?
2a. Your First Solution How do I start a new solution, choose a layout and get to a green pull-request gate?
2b. Adopting an Existing Solution How do I add the platform to a repository that already runs a service, in small, deployable steps?
3. Bringing Your Company Stack Where do my logging and metrics backend, auth, private feeds and deployment plug in?
4. Onboarding Recipes How do I set up the first test project, the mock server, a module, validated settings, a health check, a worker and telemetry?
5. Pitfalls Why did this break, and what do others do about it?

Platform features

Guide What it covers
Layered Architecture The layers, the toolkit’s DI modules, the layering check and the dependency map.
Automation Preferences Optional root-level automation overrides, settings inventory, defaults, precedence and explicit editing commands.
Observability ICoreTelemetry and AppTelemetry, standard logging and metrics, OTLP, optional Serilog, correlation IDs, Datadog and New Relic configuration, testing telemetry.
Database Providers The provider-agnostic persistence layer, PostgreSQL/Oracle/MySQL specifics, adding a provider.
Mock Server Standing in for HTTP upstreams: expectations, your own host, assertions and recording.
Building UIs Web.Ui: Blazor startup, cookie-session login, environment catalog, downstream API clients, components.
Anarchy Automation Builds The Automation.Build components, test discovery and runners, artifacts, releases and CLI tool wrappers.
CLI Tool The anarchy-toolkit CLI: bootstrapping a solution and scaffolding APIs, jobs and UIs.

The Package Catalog documents each package, including the Testing.* kits, and answers Which package do I need? for the families that are split by role (Automation*, Infrastructure.Persistence.Db.* and Testing.Db.*, Core.Telemetry and Infrastructure.Telemetry.Serilog).