Skip to main content
View as Markdown

Architecture Overview

A high-level view of how Decodx works.

System Design​

Decodx is organized as a monorepo with several key components:

Core Packages​

  • contracts — Shared schemas and types
  • engine — Pipeline core and rendering logic
  • client — Isomorphic HTTP client

Applications​

  • cli — Customer-facing command-line interface
  • web — Authoring and management interface
  • website — Documentation (this site)

Services​

  • api — Cloud rendering service
  • engine-worker — Background job processor

Data Flow​

Spec (YAML) → Parser → Compiler → Renderer → Output (MP4)
               ↓
            Cache Layer

Determinism Guarantee​

Decodx uses:

  • Pinned dependency versions
  • Deterministic rendering engine
  • Committed fixture data
  • Checksummed outputs

Learn more in the Pipeline Architecture.