# Core Architecture

URL: /bengal/docs/0.5.0/reference/architecture/core/
Section: core

--------------------------------------------------------------------------------

Core Architecture Foundational data models and build coordination for Bengal's static site generation. Component Responsibility Module Site Central container, holds all content bengal/core/site/ Page Single content page with metadata bengal/core/page/ Section Directory container, holds children bengal/core/section/ Asset Static file with processing metadata bengal/core/asset/ Design Principles No God Objects: Each class has single responsibility (Site uses 7 focused mixins) Passive Core: Core models (PageCore, Section) are data-only; Site and Asset provide I/O convenience APIs that orchestrators coordinate Composition over Inheritance: BuildContext passes services between build phases Immutable PageCore: PageCore uses frozen=True for thread-safety and cache integrity (Python 3.14t compatible) In This Section Topic Description Cache Build cache system with Zstandard compression Content Types Strategy pattern for type-specific behavior Data Flow How data moves through the build pipeline Object Model Core data structures and relationships Orchestration Build phase coordination Pipeline Rendering pipeline architecture Info Seealso Design Principles — Full architectural guidelines

--------------------------------------------------------------------------------

Metadata:
- Author: lbliii
- Word Count: 149
- Reading Time: 1 minutes