Principles
The guiding ideas behind VelvetCMS Core.
VelvetCMS Core is built around explicit, traceable control flow. The framework avoids hidden behavior and favors clarity over surprise.
Zero-magic, pragmatic #
| Principle | Description |
|---|---|
| Explicit over implicit | Services are registered manually in providers |
| Autowiring as fallback | Helpful for controllers and commands, not a hidden default |
| No facades | Dependencies are real and injected |
| No guessing | Configuration is explicit and loaded from PHP files |
What we avoid #
- Runtime magic that hides the request lifecycle
- Global state that cannot be traced or swapped
- Convention-over-configuration that obscures intent
Content-first #
Routing, storage, and caching are optimized for content delivery. VelvetCMS is a framework for content applications, not a generic app shell.
Modular core #
Everything is designed to be extended by modules with clear boundaries and dependency checks.