Foundations

Core concepts that underpin the SPLENT ecosystem. Understanding these is essential before working with the CLI or the framework.

• Feature anatomy. What a feature is, archetypes, directory structure, key files, contracts
• Feature lifecycle. States, transitions, guards, signals, manifest
• Extensibility. Template hooks, refinement, service locator, extension points, validation
• Feature testing. Test environment, fixtures, test levels, running tests
• Sources of truth. pyproject.toml, UVL, and splent.manifest.json
• Port offset. Automatic port adjustment per product to avoid collisions
• Env placeholders. __PRODUCT__ and __FEATURE_HOST_DIR__ automatic substitutions during merge

---

Table of contents

• Feature lifecycle
• Feature anatomy
• Sources of truth
• Extensibility
• Feature testing
• Port offset
• Env placeholders
• Features that run a server
• Markdown and code
• Translations
• Feature settings