Architecture Overview

The current Curvea Engine is organized into focused modules.

Main areas

src/cli
src/parser
src/resolver
src/renderer
src/content
src/builtins
src/utils

High-level pipeline

CLI command
  → load config
  → prepare assets
  → parse pages
  → create page build entries
  → resolve templates
  → render document
  → write output

Parser

The parser reads .csc files and extracts:

• file kind
• name
• props
• layout usage
• imports
• data loads
• pagination config
• data block
• SEO block
• style blocks
• script blocks
• template body

Resolver

The resolver handles:

• loops
• conditionals
• variables
• components
• layouts
• loaded data
• raw code blocks
• built-ins

Renderer

The renderer turns resolved page output into final HTML using:

• document shell
• generated head tags
• body scripts
• theme runtime
• base path rewriting
• formatting

Content system

The content system loads Markdown collections and creates page data for collection index and dynamic content pages.

Asset pipeline

The asset pipeline prepares:

• public files
• CSS
• JavaScript modules
• source assets
• vendor files

Built-ins

Built-ins are lightweight transformations or script injections applied to final HTML.