# Architecture Overview

> A high-level view of how Decodx is organized and how a render flows.

# 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](./pipeline).