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