# f/awesome-chatgpt-prompts architecture

> Architecture diagram of the GitHub repository f/awesome-chatgpt-prompts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/f/awesome-chatgpt-prompts
- Repository: https://github.com/f/awesome-chatgpt-prompts
- Video tour (about a minute): https://gitdiagram.com/f/awesome-chatgpt-prompts/video

## Overview

prompts.chat is an open-source AI prompt library and community platform. A user browses or searches prompts, opens a prompt, fills variables, and can contribute or run it; the platform also publishes CSV/JSON exports. Distinct branches provide bots and handoff teams, an interactive learning book and kids’ game, AI-assisted prompt/media tools, and MCP/CLI/Raycast integrations. The graph combines README-documented capabilities with source-index references and excerpts; unsampled subsystem internals and their runtime wiring are not inferred.

Main entry points: [`src/app/api/prompts/route.ts`](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompts/route.ts) (Prompt API), [`src/lib/mcp/server.ts`](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/server.ts) (MCP Server), [`src/app/api/prompt-builder/chat/route.ts`](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompt-builder/chat/route.ts) (Builder Chat), [`src/app/prompts/(list)/page.tsx`](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/prompts/(list)/page.tsx) (Prompt Web)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Prompt Library"]
  node_prompt_web["Prompt Web<br/>[page.tsx]"]
  node_prompt_api["Prompt API<br/>[route.ts]"]
  node_prompt_write["Prompt Writes<br/>[prompt-write.ts]"]
  node_prompt_store[("Prompt Store<br/>[db.ts]")]
  node_exports["Data Exports<br/>[route.ts]"]
  node_auth["Authentication<br/>[index.ts]"]
end

subgraph group_agents["Bots &amp; Teams"]
  node_bot_pages["Bot Catalog<br/>[page.tsx]"]
  node_team_pages["Bot Teams<br/>[page.tsx]"]
end

subgraph group_learning["Learning Experiences"]
  node_book["Prompting Book<br/>[page.tsx]"]
  node_kids["Kids Adventure"]
end

subgraph group_ai["AI Tools"]
  node_builder_route["Builder Chat<br/>[route.ts]"]
  node_builder_tools["Builder Tools"]
  node_prompt_loader["Prompt Loader<br/>[load-prompt.ts]"]
  node_media_route["Media Generation<br/>[route.ts]"]
  node_media_plugins["Media Providers<br/>[index.ts]"]
end

subgraph group_integrations["Integrations"]
  node_mcp_server["MCP Server<br/>[server.ts]"]
  node_mcp_prompt_tools["MCP Prompt Tools<br/>[prompts.ts]"]
  node_mcp_bot_tools["MCP Bot Tools<br/>[bots.ts]"]
  node_mcp_skill_tools["MCP Skill Tools<br/>[skills.ts]"]
  node_cli["Prompt CLI<br/>[index.tsx]"]
  node_raycast["Raycast Extension<br/>[search-prompts.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_prompt_web
node_prompt_web -.->|"requests prompts"| node_prompt_api
node_prompt_api -->|"queries"| node_prompt_store
node_prompt_api -->|"creates via"| node_prompt_write
node_prompt_api -->|"authenticates"| node_auth
node_exports -->|"reads prompts"| node_prompt_store
node_visitor -->|"downloads"| node_exports
node_visitor -->|"discovers bots"| node_bot_pages
node_visitor -->|"explores teams"| node_team_pages
node_mcp_server -->|"registers"| node_mcp_prompt_tools
node_mcp_server -->|"registers"| node_mcp_bot_tools
node_mcp_server -->|"registers"| node_mcp_skill_tools
node_visitor -->|"connects via MCP"| node_mcp_server
node_visitor -->|"uses CLI"| node_cli
node_visitor -.->|"searches prompts"| node_raycast
node_visitor -->|"learns prompting"| node_book
node_visitor -->|"plays lessons"| node_kids
node_visitor -.->|"builds prompts"| node_builder_route
node_builder_route -->|"executes tools"| node_builder_tools
node_builder_route -->|"loads instructions"| node_prompt_loader
node_visitor -.->|"generates media"| node_media_route
node_media_route -->|"uses providers"| node_media_plugins

click node_prompt_web "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/prompts/(list)/page.tsx"
click node_prompt_api "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompts/route.ts"
click node_prompt_write "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/prompt-write.ts"
click node_prompt_store "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/db.ts"
click node_exports "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/prompts.csv/route.ts"
click node_auth "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/auth/index.ts"
click node_bot_pages "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/bots/page.tsx"
click node_team_pages "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/bots/teams/page.tsx"
click node_mcp_server "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/server.ts"
click node_mcp_prompt_tools "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/prompts.ts"
click node_mcp_bot_tools "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/bots.ts"
click node_mcp_skill_tools "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/skills.ts"
click node_cli "https://github.com/f/awesome-chatgpt-prompts/blob/main/packages/prompts.chat/src/cli/index.tsx"
click node_raycast "https://github.com/f/awesome-chatgpt-prompts/blob/main/packages/raycast-extension/src/search-prompts.tsx"
click node_book "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/book/page.tsx"
click node_kids "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/components/kids/elements/drag-drop-prompt.tsx"
click node_builder_route "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompt-builder/chat/route.ts"
click node_builder_tools "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/ai/prompt-builder-tools.ts"
click node_prompt_loader "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/ai/load-prompt.ts"
click node_media_route "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/media-generate/route.ts"
click node_media_plugins "https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/plugins/media-generators/index.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_prompt_web,node_prompt_api,node_prompt_write,node_prompt_store,node_exports,node_auth toneBlue
class node_bot_pages,node_team_pages toneAmber
class node_book,node_kids toneMint
class node_builder_route,node_builder_tools,node_prompt_loader,node_media_route,node_media_plugins toneRose
class node_mcp_server,node_mcp_prompt_tools,node_mcp_bot_tools,node_mcp_skill_tools,node_cli,node_raycast,node_visitor toneIndigo
```

## Components

### Prompt Library

- [Prompt Web](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/prompts/(list)/page.tsx): `src/app/prompts/(list)/page.tsx`
- [Prompt API](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompts/route.ts): `src/app/api/prompts/route.ts`
- [Prompt Writes](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/prompt-write.ts): `src/lib/prompt-write.ts`
- [Prompt Store](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Data Exports](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/prompts.csv/route.ts): `src/app/prompts.csv/route.ts`
- [Authentication](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/auth/index.ts): `src/lib/auth/index.ts`

### Bots & Teams

- [Bot Catalog](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/bots/page.tsx): `src/app/bots/page.tsx`
- [Bot Teams](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/bots/teams/page.tsx): `src/app/bots/teams/page.tsx`

### Learning Experiences

- [Prompting Book](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/book/page.tsx): `src/app/book/page.tsx`
- [Kids Adventure](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/components/kids/elements/drag-drop-prompt.tsx): `src/components/kids/elements/drag-drop-prompt.tsx`

### AI Tools

- [Builder Chat](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/prompt-builder/chat/route.ts): `src/app/api/prompt-builder/chat/route.ts`
- [Builder Tools](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/ai/prompt-builder-tools.ts): `src/lib/ai/prompt-builder-tools.ts`
- [Prompt Loader](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/ai/load-prompt.ts): `src/lib/ai/load-prompt.ts`
- [Media Generation](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/app/api/media-generate/route.ts): `src/app/api/media-generate/route.ts`
- [Media Providers](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/plugins/media-generators/index.ts): `src/lib/plugins/media-generators/index.ts`

### Integrations

- [MCP Server](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/server.ts): `src/lib/mcp/server.ts`
- [MCP Prompt Tools](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/prompts.ts): `src/lib/mcp/tools/prompts.ts`
- [MCP Bot Tools](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/bots.ts): `src/lib/mcp/tools/bots.ts`
- [MCP Skill Tools](https://github.com/f/awesome-chatgpt-prompts/blob/main/src/lib/mcp/tools/skills.ts): `src/lib/mcp/tools/skills.ts`
- [Prompt CLI](https://github.com/f/awesome-chatgpt-prompts/blob/main/packages/prompts.chat/src/cli/index.tsx): `packages/prompts.chat/src/cli/index.tsx`
- [Raycast Extension](https://github.com/f/awesome-chatgpt-prompts/blob/main/packages/raycast-extension/src/search-prompts.tsx): `packages/raycast-extension/src/search-prompts.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Prompt Web: browses (evidence: `README.md`)
- Prompt Web → Prompt API: requests prompts
- Prompt API → Prompt Store: queries (evidence: `src/app/api/prompts/route.ts`)
- Prompt API → Prompt Writes: creates via (evidence: `src/app/api/prompts/route.ts`)
- Prompt API → Authentication: authenticates (evidence: `src/app/api/prompts/route.ts`)
- Data Exports → Prompt Store: reads prompts (evidence: `src/app/prompts.csv/route.ts`)
- Visitor → Data Exports: downloads (evidence: `README.md`)
- Visitor → Bot Catalog: discovers bots (evidence: `README.md`)
- Visitor → Bot Teams: explores teams (evidence: `README.md`)
- MCP Server → MCP Prompt Tools: registers (evidence: `src/lib/mcp/server.ts`)
- MCP Server → MCP Bot Tools: registers (evidence: `src/lib/mcp/server.ts`)
- MCP Server → MCP Skill Tools: registers (evidence: `src/lib/mcp/server.ts`)
- Visitor → MCP Server: connects via MCP (evidence: `README.md`)
- Visitor → Prompt CLI: uses CLI (evidence: `README.md`)
- Visitor → Raycast Extension: searches prompts
- Visitor → Prompting Book: learns prompting (evidence: `README.md`)
- Visitor → Kids Adventure: plays lessons (evidence: `README.md`)
- Visitor → Builder Chat: builds prompts
- Builder Chat → Builder Tools: executes tools (evidence: `src/app/api/prompt-builder/chat/route.ts`)
- Builder Chat → Prompt Loader: loads instructions (evidence: `src/app/api/prompt-builder/chat/route.ts`)
- Visitor → Media Generation: generates media
- Media Generation → Media Providers: uses providers (evidence: `src/app/api/media-generate/route.ts`)
