> ## Documentation Index
> Fetch the complete documentation index at: https://boutiquedb.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BoutiqueDB Architecture

> Deep dive into BoutiqueDB target modules, swift-structured-queries driver integration, and DatabaseActor thread isolation.

`BoutiqueDB` is organized into focused Swift targets, balancing SQLite-compatible C APIs with high-level Swift ergonomics.

***

## Target Layer Architecture

```
BoutiqueDB/
├── Package.swift
├── Sources/
│   ├── BoutiqueDB/                     # Main public framework API & DatabaseActor
│   ├── TursoKit/                       # Native C ABI handles, Statement execution, CDC
│   ├── StructuredQueriesTurso/         # StructuredQueries driver integration
│   ├── TursoCKSync/                    # CKSyncEngine CloudKit synchronizer
│   └── TursoObservation/               # CDC change token invalidation engine
└── Vendor/
    └── TursoSDK.xcframework            # Prebuilt libturso_sdk_kit multi-arch binary
```

***

## Component Responsibilities

> [card] BoutiqueDB Target
>
> Public API umbrella containing `BoutiqueDB`, `@LiveQuery`, `@LiveQueryOne`, and `@BoutiqueTable` macro wrappers.

> [card] StructuredQueriesTurso
>
> Swift driver mapping `StructuredQueries` expressions (`@Table`) to Turso SQLite database connections.

> [card] TursoObservation
>
> Monitors `turso_cdc` table change counters and dispatches change token invalidations to active subscriber queries.

> [card] TursoCKSync
>
> Serializes changed CDC rows into CloudKit `CKRecord` structures for `CKSyncEngine` processing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.