Learn Aggrega
A path through the documentation, in the order to read it the first time. Each step says what it teaches and links the pages that teach it.
- Getting started. Something running on your machine first: Getting started installs Aggrega, writes a runnable example into a folder, builds and runs it, then grows it one step at a time.
- The ideas behind Aggrega. What Aggrega is for and where it sits: Vision and Positioning. How the work divides between the people who describe an application and the people who decide how and where it runs: Team Topologies and the Four Domains. The kinds of file you write, and which domain each belongs to: The Entity Taxonomy.
- A first real example. A complete workspace you build with the
aggregaCLI, and the files the build writes: Catalog-only — MariaDB + Adminer with zero platform authoring, the first example assembled from the catalog alone once Getting started’s examples are done. The teaching order lists every example after it, tier by tier, and the same page finds one by the product it deploys or what it shows. - Writing your own files. The loop that takes a file from blank to validated: Authoring Aggrega files. Which files are yours to write: Personas and Entities by Role. Starting from a project you already have in another format: Import.
- The catalog and Features. Where the components you use come from, and how they are published and pinned: Catalog and Registry. How a Feature attaches an operational behaviour to a component: Features and Policies, then the Feature reference.
- The reference. Every entity, keyword, template, command and error: Language Reference, starting with How to use this reference.