# vllm-project/recipes architecture

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

- Interactive diagram: https://gitdiagram.com/vllm-project/recipes
- Repository: https://github.com/vllm-project/recipes

## Overview

vLLM Recipes is a web catalog for finding model-serving recipes and producing vLLM deployment commands. The main workflow is browse or search the recipe catalog, open a model’s detail page, select configuration options, and copy a generated command. The graph also includes provider pages, deployment-platform links, and the documented full-text recipe feed. Relationships are limited to README statements and SOURCE INDEX references; unsampled modules are represented only where their role is supported by the tree or documentation.

Main entry points: [`src/app/[org]/[repo]/page.js`](https://github.com/vllm-project/recipes/blob/main/src/app/%5Borg%5D/%5Brepo%5D/page.js) (Recipe detail), [`src/lib/recipes.js`](https://github.com/vllm-project/recipes/blob/main/src/lib/recipes.js) (Recipe loader), [`src/components/recipes/CommandBuilder.jsx`](https://github.com/vllm-project/recipes/blob/main/src/components/recipes/CommandBuilder.jsx) (Command builder), [`src/app/browse/page.js`](https://github.com/vllm-project/recipes/blob/main/src/app/browse/page.js) (Browse page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog and discovery"]
  node_home["Home page<br/>[page.js]"]
  node_site_layout["Site layout<br/>[layout.js]"]
  node_search_ui["Search box<br/>[SearchBox.jsx]"]
  node_search_logic["Search logic<br/>[search.js]"]
  node_browse_page["Browse page<br/>[page.js]"]
  node_browse_list["Browse list<br/>[BrowseList.jsx]"]
  node_provider_page["Provider page<br/>[page.js]"]
end

subgraph group_recipe["Recipe pages"]
  node_recipe_page["Recipe detail<br/>[page.js]"]
  node_recipe_utils["Recipe utilities<br/>[recipe-utils.js]"]
  node_taxonomy["Hardware taxonomy<br/>[taxonomy.js]"]
  node_strategies["Serving strategies<br/>[strategies.js]"]
end

subgraph group_commands["Command configuration"]
  node_command_ui["Command builder<br/>[CommandBuilder.jsx]"]
  node_synthesis["Command synthesis"]
  node_omni_tasks["Omni task templates<br/>[omni-tasks.js]"]
  node_cluster_endpoints["Cluster endpoints"]
  node_preferences["User preferences<br/>[preferences.js]"]
  node_deploy_dialog["Deploy dialog<br/>[DeployDialog.jsx]"]
  node_platforms["Platform logos<br/>[PlatformLogos.jsx]"]
end

subgraph group_content["Recipe data and feeds"]
  node_recipe_data["Recipe loader<br/>[recipes.js]"]
  node_provider_data["Provider metadata<br/>[providers.js]"]
  node_full_feed["Full-text feed<br/>[route.js]"]
  node_llms_feed["Recipe index feed<br/>[route.js]"]
  node_recipe_store[("YAML recipe sources")]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"uses"| node_site_layout
node_home -->|"loads recipes"| node_recipe_data
node_home -->|"renders within"| node_site_layout
node_site_layout -->|"renders"| node_search_ui
node_site_layout -->|"loads recipes"| node_recipe_data
node_search_ui -->|"searches"| node_search_logic
node_search_ui -->|"builds recipe links"| node_recipe_utils
node_browse_page -->|"loads recipes"| node_recipe_data
node_browse_page -->|"loads taxonomy"| node_taxonomy
node_browse_page -->|"uses synthesis"| node_synthesis
node_browse_page -->|"renders"| node_browse_list
node_browse_list -->|"searches"| node_search_logic
node_browse_list -->|"uses provider data"| node_provider_data
node_provider_page -->|"loads recipes"| node_recipe_data
node_provider_page -->|"uses provider data"| node_provider_data
node_recipe_page -->|"loads recipe"| node_recipe_data
node_recipe_page -->|"builds recipe links"| node_recipe_utils
node_recipe_page -->|"loads taxonomy"| node_taxonomy
node_recipe_page -->|"loads strategies"| node_strategies
node_recipe_page -->|"renders"| node_command_ui
node_recipe_page -->|"renders"| node_deploy_dialog
node_command_ui -->|"synthesizes command"| node_synthesis
node_command_ui -->|"resolves tasks"| node_omni_tasks
node_command_ui -->|"uses endpoints"| node_cluster_endpoints
node_command_ui -->|"uses preferences"| node_preferences
node_deploy_dialog -->|"uses logos"| node_platforms
node_recipe_data -->|"reads YAML"| node_recipe_store
node_full_feed -->|"loads recipes"| node_recipe_data
node_llms_feed -->|"loads recipes"| node_recipe_data
node_visitor -->|"browses"| node_browse_page
node_visitor -->|"views recipe"| node_recipe_page
node_visitor -->|"fetches corpus"| node_full_feed

click node_home "https://github.com/vllm-project/recipes/blob/main/src/app/page.js"
click node_site_layout "https://github.com/vllm-project/recipes/blob/main/src/app/layout.js"
click node_search_ui "https://github.com/vllm-project/recipes/blob/main/src/components/recipes/SearchBox.jsx"
click node_search_logic "https://github.com/vllm-project/recipes/blob/main/src/lib/search.js"
click node_browse_page "https://github.com/vllm-project/recipes/blob/main/src/app/browse/page.js"
click node_browse_list "https://github.com/vllm-project/recipes/blob/main/src/components/recipes/BrowseList.jsx"
click node_provider_page "https://github.com/vllm-project/recipes/blob/main/src/app/%5Borg%5D/page.js"
click node_recipe_data "https://github.com/vllm-project/recipes/blob/main/src/lib/recipes.js"
click node_provider_data "https://github.com/vllm-project/recipes/blob/main/src/lib/providers.js"
click node_recipe_page "https://github.com/vllm-project/recipes/blob/main/src/app/%5Borg%5D/%5Brepo%5D/page.js"
click node_recipe_utils "https://github.com/vllm-project/recipes/blob/main/src/lib/recipe-utils.js"
click node_taxonomy "https://github.com/vllm-project/recipes/blob/main/src/lib/taxonomy.js"
click node_strategies "https://github.com/vllm-project/recipes/blob/main/src/lib/strategies.js"
click node_command_ui "https://github.com/vllm-project/recipes/blob/main/src/components/recipes/CommandBuilder.jsx"
click node_synthesis "https://github.com/vllm-project/recipes/blob/main/src/lib/command-synthesis.js"
click node_omni_tasks "https://github.com/vllm-project/recipes/blob/main/src/lib/omni-tasks.js"
click node_cluster_endpoints "https://github.com/vllm-project/recipes/blob/main/src/lib/cluster-endpoints.js"
click node_preferences "https://github.com/vllm-project/recipes/blob/main/src/lib/preferences.js"
click node_deploy_dialog "https://github.com/vllm-project/recipes/blob/main/src/components/recipes/DeployDialog.jsx"
click node_platforms "https://github.com/vllm-project/recipes/blob/main/src/components/icons/PlatformLogos.jsx"
click node_full_feed "https://github.com/vllm-project/recipes/blob/main/src/app/llms-full.txt/route.js"
click node_llms_feed "https://github.com/vllm-project/recipes/blob/main/src/app/llms.txt/route.js"
click node_recipe_store "https://github.com/vllm-project/recipes/tree/main/models"

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_home,node_site_layout,node_search_ui,node_search_logic,node_browse_page,node_browse_list,node_provider_page toneBlue
class node_recipe_page,node_recipe_utils,node_taxonomy,node_strategies toneAmber
class node_command_ui,node_synthesis,node_omni_tasks,node_cluster_endpoints,node_preferences,node_deploy_dialog,node_platforms toneMint
class node_recipe_data,node_provider_data,node_full_feed,node_llms_feed,node_recipe_store toneRose
class node_visitor toneIndigo
```

## Components

### Catalog and discovery

- [Home page](https://github.com/vllm-project/recipes/blob/main/src/app/page.js): `src/app/page.js`
- [Site layout](https://github.com/vllm-project/recipes/blob/main/src/app/layout.js): `src/app/layout.js`
- [Search box](https://github.com/vllm-project/recipes/blob/main/src/components/recipes/SearchBox.jsx): `src/components/recipes/SearchBox.jsx`
- [Search logic](https://github.com/vllm-project/recipes/blob/main/src/lib/search.js): `src/lib/search.js`
- [Browse page](https://github.com/vllm-project/recipes/blob/main/src/app/browse/page.js): `src/app/browse/page.js`
- [Browse list](https://github.com/vllm-project/recipes/blob/main/src/components/recipes/BrowseList.jsx): `src/components/recipes/BrowseList.jsx`
- [Provider page](https://github.com/vllm-project/recipes/blob/main/src/app/%5Borg%5D/page.js): `src/app/[org]/page.js`

### Recipe pages

- [Recipe detail](https://github.com/vllm-project/recipes/blob/main/src/app/%5Borg%5D/%5Brepo%5D/page.js): `src/app/[org]/[repo]/page.js`
- [Recipe utilities](https://github.com/vllm-project/recipes/blob/main/src/lib/recipe-utils.js): `src/lib/recipe-utils.js`
- [Hardware taxonomy](https://github.com/vllm-project/recipes/blob/main/src/lib/taxonomy.js): `src/lib/taxonomy.js`
- [Serving strategies](https://github.com/vllm-project/recipes/blob/main/src/lib/strategies.js): `src/lib/strategies.js`

### Command configuration

- [Command builder](https://github.com/vllm-project/recipes/blob/main/src/components/recipes/CommandBuilder.jsx): `src/components/recipes/CommandBuilder.jsx`
- [Command synthesis](https://github.com/vllm-project/recipes/blob/main/src/lib/command-synthesis.js): `src/lib/command-synthesis.js`
- [Omni task templates](https://github.com/vllm-project/recipes/blob/main/src/lib/omni-tasks.js): `src/lib/omni-tasks.js`
- [Cluster endpoints](https://github.com/vllm-project/recipes/blob/main/src/lib/cluster-endpoints.js): `src/lib/cluster-endpoints.js`
- [User preferences](https://github.com/vllm-project/recipes/blob/main/src/lib/preferences.js): `src/lib/preferences.js`
- [Deploy dialog](https://github.com/vllm-project/recipes/blob/main/src/components/recipes/DeployDialog.jsx): `src/components/recipes/DeployDialog.jsx`
- [Platform logos](https://github.com/vllm-project/recipes/blob/main/src/components/icons/PlatformLogos.jsx): `src/components/icons/PlatformLogos.jsx`

### Recipe data and feeds

- [Recipe loader](https://github.com/vllm-project/recipes/blob/main/src/lib/recipes.js): `src/lib/recipes.js`
- [Provider metadata](https://github.com/vllm-project/recipes/blob/main/src/lib/providers.js): `src/lib/providers.js`
- [Full-text feed](https://github.com/vllm-project/recipes/blob/main/src/app/llms-full.txt/route.js): `src/app/llms-full.txt/route.js`
- [Recipe index feed](https://github.com/vllm-project/recipes/blob/main/src/app/llms.txt/route.js): `src/app/llms.txt/route.js`
- [YAML recipe sources](https://github.com/vllm-project/recipes/tree/main/models): `models`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens (evidence: `src/app/page.js`)
- Visitor → Site layout: uses (evidence: `src/app/layout.js`)
- Home page → Recipe loader: loads recipes (evidence: `src/app/page.js`)
- Home page → Site layout: renders within (evidence: `src/app/layout.js`)
- Site layout → Search box: renders (evidence: `src/app/layout.js`)
- Site layout → Recipe loader: loads recipes (evidence: `src/app/layout.js`)
- Search box → Search logic: searches (evidence: `src/components/recipes/SearchBox.jsx`)
- Search box → Recipe utilities: builds recipe links (evidence: `src/components/recipes/SearchBox.jsx`)
- Browse page → Recipe loader: loads recipes (evidence: `src/app/browse/page.js`)
- Browse page → Hardware taxonomy: loads taxonomy (evidence: `src/app/browse/page.js`)
- Browse page → Command synthesis: uses synthesis (evidence: `src/app/browse/page.js`)
- Browse page → Browse list: renders (evidence: `src/app/browse/page.js`)
- Browse list → Search logic: searches (evidence: `src/components/recipes/BrowseList.jsx`)
- Browse list → Provider metadata: uses provider data (evidence: `src/components/recipes/BrowseList.jsx`)
- Provider page → Recipe loader: loads recipes (evidence: `src/app/[org]/page.js`)
- Provider page → Provider metadata: uses provider data (evidence: `src/app/[org]/page.js`)
- Recipe detail → Recipe loader: loads recipe (evidence: `src/app/[org]/[repo]/page.js`)
- Recipe detail → Recipe utilities: builds recipe links (evidence: `src/app/[org]/[repo]/page.js`)
- Recipe detail → Hardware taxonomy: loads taxonomy (evidence: `src/app/[org]/[repo]/page.js`)
- Recipe detail → Serving strategies: loads strategies (evidence: `src/app/[org]/[repo]/page.js`)
- Recipe detail → Command builder: renders (evidence: `src/app/[org]/[repo]/page.js`)
- Recipe detail → Deploy dialog: renders (evidence: `src/app/[org]/[repo]/page.js`)
- Command builder → Command synthesis: synthesizes command (evidence: `src/components/recipes/CommandBuilder.jsx`)
- Command builder → Omni task templates: resolves tasks (evidence: `src/components/recipes/CommandBuilder.jsx`)
- Command builder → Cluster endpoints: uses endpoints (evidence: `src/components/recipes/CommandBuilder.jsx`)
- Command builder → User preferences: uses preferences (evidence: `src/components/recipes/CommandBuilder.jsx`)
- Deploy dialog → Platform logos: uses logos (evidence: `src/components/recipes/DeployDialog.jsx`)
- Recipe loader → YAML recipe sources: reads YAML (evidence: `src/lib/recipes.js`)
- Full-text feed → Recipe loader: loads recipes (evidence: `src/app/llms-full.txt/route.js`)
- Recipe index feed → Recipe loader: loads recipes (evidence: `src/app/llms.txt/route.js`)
- Visitor → Browse page: browses (evidence: `README.md`)
- Visitor → Recipe detail: views recipe (evidence: `README.md`)
- Visitor → Full-text feed: fetches corpus (evidence: `src/app/llms-full.txt/route.js`)
