# lynstack/recipe architecture

> Architecture diagram of the GitHub repository lynstack/recipe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lynstack/recipe
- Repository: https://github.com/lynstack/recipe

## Overview

lynstack recipe is a TypeScript library for compiling variant configurations into cached values, class names, or React Native styles. A component author defines a recipe and calls it with a variant selection; the engine resolves defaults and compounds, composes recipe layers, and returns the selected result. The class and native packages adapt that engine for their respective outputs, including slot-based recipes and themed native recipes. Edges follow excerpts, indexed references, or README statements; unsampled capabilities are represented without asserting unverified internal calls.

Main entry points: [`packages/recipe/src/recipe-kind.ts`](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/recipe-kind.ts) (Recipe kinds), [`packages/recipe/src/slot-recipe-kind.ts`](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts) (Slot recipe kinds), [`packages/class-recipe/src/compile-recipe.ts`](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-recipe.ts) (Class compilation), [`packages/class-recipe/src/compile-slot-recipe.ts`](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-slot-recipe.ts) (Slot class compilation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engine["Generic engine"]
  node_engine_api["Recipe kinds<br/>[recipe-kind.ts]"]
  node_slot_engine["Slot recipe kinds"]
  node_variant_compile["Variant compilation<br/>[variants.ts]"]
  node_selection_index["Selection indexing<br/>[selector.ts]"]
  node_composition["Layer composition<br/>[compose.ts]"]
  node_recipe_build["Value building<br/>[build-recipe.ts]"]
  node_slot_values["Slot value building<br/>[slots.ts]"]
  node_value_reduction["Value reduction<br/>[reduce-values.ts]"]
end

subgraph group_classes["Class recipes"]
  node_class_recipe["Class recipes<br/>[recipe.ts]"]
  node_class_compile["Class compilation<br/>[compile-recipe.ts]"]
  node_class_slots["Slot class recipes<br/>[slot-recipe.ts]"]
  node_class_slot_compile["Slot class compilation"]
  node_class_options["Class build options<br/>[build-options.ts]"]
  node_class_join["Class joining<br/>[join-classes.ts]"]
  node_class_cx["Class utility<br/>[cx.ts]"]
end

subgraph group_native["Native recipes"]
  node_native_recipe["Style recipes<br/>[style-recipe.ts]"]
  node_native_compile["Style compilation"]
  node_native_slots["Slot style recipes"]
  node_native_slot_compile["Slot style compilation"]
  node_themed["Themed recipes<br/>[themed-recipes.ts]"]
  node_themed_compile["Theme compilation"]
end

node_author(("Component author"))
node_selection["Variant selection"]
node_result["Recipe result"]

node_author -->|"defines recipe"| node_class_recipe
node_author -->|"defines recipe"| node_native_recipe
node_class_recipe -->|"builds"| node_class_compile
node_class_slots -->|"builds"| node_class_slot_compile
node_class_compile -->|"creates engine recipe"| node_engine_api
node_class_slot_compile -->|"creates engine recipe"| node_slot_engine
node_class_compile -->|"uses options"| node_class_options
node_class_slot_compile -->|"uses options"| node_class_options
node_class_options -->|"defaults to"| node_class_cx
node_class_compile -->|"joins classes"| node_class_join
node_class_slot_compile -->|"joins classes"| node_class_join
node_class_join -->|"uses default join"| node_class_cx
node_author -->|"defines slots"| node_native_slots
node_native_recipe -->|"builds"| node_native_compile
node_native_slots -->|"builds"| node_native_slot_compile
node_native_compile -->|"creates engine recipe"| node_engine_api
node_native_slot_compile -->|"creates engine recipe"| node_slot_engine
node_themed -->|"builds themed recipe"| node_themed_compile
node_themed -->|"builds style recipe"| node_native_compile
node_themed -->|"builds slot recipe"| node_native_slot_compile
node_engine_api -->|"merges layers"| node_composition
node_engine_api -->|"compiles values"| node_recipe_build
node_engine_api -->|"creates selector"| node_selection_index
node_engine_api -->|"compiles variants"| node_variant_compile
node_slot_engine -->|"merges layers"| node_composition
node_slot_engine -->|"creates selector"| node_selection_index
node_slot_engine -->|"compiles variants"| node_variant_compile
node_slot_engine -->|"creates slot builder"| node_slot_values
node_recipe_build -->|"uses compiled variants"| node_variant_compile
node_recipe_build -->|"reduces values"| node_value_reduction
node_slot_values -->|"reduces slot values"| node_value_reduction
node_selection -->|"calls"| node_class_recipe
node_selection -.->|"calls"| node_native_recipe
node_class_recipe -->|"returns classes"| node_result
node_native_recipe -->|"returns styles"| node_result

click node_engine_api "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/recipe-kind.ts"
click node_slot_engine "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts"
click node_variant_compile "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/variants.ts"
click node_selection_index "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/selector.ts"
click node_composition "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/compose.ts"
click node_recipe_build "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/build-recipe.ts"
click node_slot_values "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/slots.ts"
click node_value_reduction "https://github.com/lynstack/recipe/blob/main/packages/recipe/src/reduce-values.ts"
click node_class_recipe "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/recipe.ts"
click node_class_compile "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-recipe.ts"
click node_class_slots "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/slot-recipe.ts"
click node_class_slot_compile "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-slot-recipe.ts"
click node_class_options "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/build-options.ts"
click node_class_join "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/join-classes.ts"
click node_class_cx "https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/cx.ts"
click node_native_recipe "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/style-recipe.ts"
click node_native_compile "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-style-recipe.ts"
click node_native_slots "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/slot-style-recipe.ts"
click node_native_slot_compile "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-slot-style-recipe.ts"
click node_themed "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/themed-recipes.ts"
click node_themed_compile "https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-themed-recipe.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_engine_api,node_slot_engine,node_variant_compile,node_selection_index,node_composition,node_recipe_build,node_slot_values,node_value_reduction toneBlue
class node_class_recipe,node_class_compile,node_class_slots,node_class_slot_compile,node_class_options,node_class_join,node_class_cx toneAmber
class node_native_recipe,node_native_compile,node_native_slots,node_native_slot_compile,node_themed,node_themed_compile toneMint
class node_author,node_selection,node_result toneIndigo
```

## Components

### Generic engine

- [Recipe kinds](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/recipe-kind.ts): `packages/recipe/src/recipe-kind.ts`
- [Slot recipe kinds](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts): `packages/recipe/src/slot-recipe-kind.ts`
- [Variant compilation](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/variants.ts): `packages/recipe/src/variants.ts`
- [Selection indexing](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/selector.ts): `packages/recipe/src/selector.ts`
- [Layer composition](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/compose.ts): `packages/recipe/src/compose.ts`
- [Value building](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/build-recipe.ts): `packages/recipe/src/build-recipe.ts`
- [Slot value building](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/slots.ts): `packages/recipe/src/slots.ts`
- [Value reduction](https://github.com/lynstack/recipe/blob/main/packages/recipe/src/reduce-values.ts): `packages/recipe/src/reduce-values.ts`

### Class recipes

- [Class recipes](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/recipe.ts): `packages/class-recipe/src/recipe.ts`
- [Class compilation](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-recipe.ts): `packages/class-recipe/src/compile-recipe.ts`
- [Slot class recipes](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/slot-recipe.ts): `packages/class-recipe/src/slot-recipe.ts`
- [Slot class compilation](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/compile-slot-recipe.ts): `packages/class-recipe/src/compile-slot-recipe.ts`
- [Class build options](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/build-options.ts): `packages/class-recipe/src/build-options.ts`
- [Class joining](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/join-classes.ts): `packages/class-recipe/src/join-classes.ts`
- [Class utility](https://github.com/lynstack/recipe/blob/main/packages/class-recipe/src/cx.ts): `packages/class-recipe/src/cx.ts`

### Native recipes

- [Style recipes](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/style-recipe.ts): `packages/native-recipe/src/style-recipe.ts`
- [Style compilation](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-style-recipe.ts): `packages/native-recipe/src/compile-style-recipe.ts`
- [Slot style recipes](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/slot-style-recipe.ts): `packages/native-recipe/src/slot-style-recipe.ts`
- [Slot style compilation](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-slot-style-recipe.ts): `packages/native-recipe/src/compile-slot-style-recipe.ts`
- [Themed recipes](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/themed-recipes.ts): `packages/native-recipe/src/themed-recipes.ts`
- [Theme compilation](https://github.com/lynstack/recipe/blob/main/packages/native-recipe/src/compile-themed-recipe.ts): `packages/native-recipe/src/compile-themed-recipe.ts`

### Other components

- **Component author**
- **Variant selection**
- **Recipe result**

## Connections

- Component author → Class recipes: defines recipe (evidence: `README.md`)
- Component author → Style recipes: defines recipe (evidence: `README.md`)
- Class recipes → Class compilation: builds (evidence: `packages/class-recipe/src/recipe.ts`)
- Slot class recipes → Slot class compilation: builds (evidence: `packages/class-recipe/src/slot-recipe.ts`)
- Class compilation → Recipe kinds: creates engine recipe (evidence: `packages/class-recipe/src/compile-recipe.ts`)
- Slot class compilation → Slot recipe kinds: creates engine recipe (evidence: `packages/class-recipe/src/compile-slot-recipe.ts`)
- Class compilation → Class build options: uses options (evidence: `packages/class-recipe/src/compile-recipe.ts`)
- Slot class compilation → Class build options: uses options (evidence: `packages/class-recipe/src/compile-slot-recipe.ts`)
- Class build options → Class utility: defaults to (evidence: `packages/class-recipe/src/build-options.ts`)
- Class compilation → Class joining: joins classes (evidence: `packages/class-recipe/src/compile-recipe.ts`)
- Slot class compilation → Class joining: joins classes (evidence: `packages/class-recipe/src/compile-slot-recipe.ts`)
- Class joining → Class utility: uses default join (evidence: `packages/class-recipe/src/join-classes.ts`)
- Component author → Slot style recipes: defines slots (evidence: `README.md`)
- Style recipes → Style compilation: builds (evidence: `packages/native-recipe/src/style-recipe.ts`)
- Slot style recipes → Slot style compilation: builds (evidence: `packages/native-recipe/src/slot-style-recipe.ts`)
- Style compilation → Recipe kinds: creates engine recipe (evidence: `packages/native-recipe/src/compile-style-recipe.ts`)
- Slot style compilation → Slot recipe kinds: creates engine recipe (evidence: `packages/native-recipe/src/compile-slot-style-recipe.ts`)
- Themed recipes → Theme compilation: builds themed recipe (evidence: `packages/native-recipe/src/themed-recipes.ts`)
- Themed recipes → Style compilation: builds style recipe (evidence: `packages/native-recipe/src/themed-recipes.ts`)
- Themed recipes → Slot style compilation: builds slot recipe (evidence: `packages/native-recipe/src/themed-recipes.ts`)
- Recipe kinds → Layer composition: merges layers (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe kinds → Value building: compiles values (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe kinds → Selection indexing: creates selector (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe kinds → Variant compilation: compiles variants (evidence: `packages/recipe/src/recipe-kind.ts`)
- Slot recipe kinds → Layer composition: merges layers (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot recipe kinds → Selection indexing: creates selector (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot recipe kinds → Variant compilation: compiles variants (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot recipe kinds → Slot value building: creates slot builder (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Value building → Variant compilation: uses compiled variants (evidence: `packages/recipe/src/build-recipe.ts`)
- Value building → Value reduction: reduces values (evidence: `packages/recipe/src/build-recipe.ts`)
- Slot value building → Value reduction: reduces slot values (evidence: `packages/recipe/src/slots.ts`)
- Variant selection → Class recipes: calls (evidence: `README.md`)
- Variant selection → Style recipes: calls
- Class recipes → Recipe result: returns classes (evidence: `README.md`)
- Style recipes → Recipe result: returns styles (evidence: `README.md`)
