Foundations

The concepts the CLI and the framework are built on. Read them before you work with either, and come back when something surprises you.

Features

• Feature anatomy, what a feature is, its archetypes, files and contract
• Feature lifecycle, states, transitions, guards, signals and the manifest
• Extensibility, compose, extend or refine, template hooks, the service locator and validation
• Feature testing, test environment, fixtures, test levels and running tests
• Feature settings, where a feature declares what it reads, and how a product overrides it
• Features that run a server, one instance of a feature’s containers per product

Products

• Sources of truth, pyproject.toml, the UVL model, splent.manifest.json and the env files
• Editable and pinned features, working copies, released versions, and what production accepts
• Build, deploy and release, the three production commands and how they fit together
• Continuous delivery, checks on every push, upgrade pull requests and automatic deployment
• Port offset, a host port per product, derived from its name
• Env placeholders, __PRODUCT__ and __FEATURE_HOST_DIR__, filled in during the merge

Content

• Translations, the product’s language, translatable strings and shipping catalogues
• Markdown and code, one sanitised renderer for written material, with server-side highlighting

---

Table of contents

• Feature lifecycle
• Feature anatomy
• Sources of truth
• Extensibility
• Feature testing
• Editable and pinned features
• Build, deploy and release
• Port offset
• Env placeholders
• Features that run a server
• Markdown and code
• Translations
• Feature settings
• Continuous delivery