# dair-ai/prompt-engineering-guide architecture

> Architecture diagram of the GitHub repository dair-ai/prompt-engineering-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dair-ai/prompt-engineering-guide
- Repository: https://github.com/dair-ai/prompt-engineering-guide

## Overview

Prompt Engineering Guide is a multilingual learning and reference website: readers browse instructional material, prompting techniques, applications, prompt examples, model guides, and research resources. The tree and README establish these content areas; sampled code shows theme integration, code-block controls, prompt-file listing, and page-copy interactions. Some API implementations and page content were not sampled, so their internal data flow is left unspecified.

Main entry points: [`components/pre.tsx`](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/pre.tsx) (Code Blocks), [`components/copy-to-clipboard.tsx`](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/copy-to-clipboard.tsx) (Code Clipboard), [`theme.config.tsx`](https://github.com/dair-ai/prompt-engineering-guide/blob/main/theme.config.tsx) (Docs Theme), [`components/button.tsx`](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/button.tsx) (Action Button)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Guide Content"]
  node_intro["Prompting Basics"]
  node_techniques["Techniques"]
  node_applications["Applications"]
  node_prompt_hub["Prompt Hub"]
  node_models["Model Guides"]
  node_research["Research Papers"]
  node_risks["Risks"]
  node_datasets["Datasets<br/>[datasets.en.mdx]"]
  node_courses["Courses<br/>[courses.en.mdx]"]
end

subgraph group_site["Site Presentation"]
  node_theme["Docs Theme<br/>[theme.config.tsx]"]
  node_app_shell["App Shell<br/>[_app.tsx]"]
  node_announcement["Announcement Bar"]
end

subgraph group_tools["Reader Tools"]
  node_code_view["Code Blocks<br/>[pre.tsx]"]
  node_clipboard["Code Clipboard"]
  node_button["Action Button<br/>[button.tsx]"]
  node_copy_icon["Copy Icon<br/>[copy.tsx]"]
  node_check_icon["Copied Icon<br/>[check.tsx]"]
  node_word_wrap["Word Wrap Icon<br/>[word-wrap.tsx]"]
  node_page_copy["Page Copy Menu"]
  node_prompt_files["Prompt File List<br/>[PromptFiles.jsx]"]
end

subgraph group_data["Content APIs"]
  node_prompt_api["Prompt Files API<br/>[promptsFiles.js]"]
  node_page_api["Page Content API<br/>[getPageContent.ts]"]
end

node_reader(("Reader"))

node_reader -->|"browses guide"| node_intro
node_reader -->|"learns techniques"| node_techniques
node_reader -->|"explores use"| node_applications
node_reader -->|"browses prompts"| node_prompt_hub
node_reader -->|"explores models"| node_models
node_reader -->|"reads research"| node_research
node_reader -->|"learns risks"| node_risks
node_reader -->|"browses datasets"| node_datasets
node_reader -->|"finds courses"| node_courses
node_app_shell -->|"renders"| node_announcement
node_theme -->|"renders"| node_page_copy
node_theme -->|"configures"| node_code_view
node_code_view -->|"renders"| node_clipboard
node_code_view -->|"renders"| node_button
node_code_view -->|"renders"| node_word_wrap
node_clipboard -->|"renders"| node_button
node_clipboard -->|"renders"| node_copy_icon
node_clipboard -->|"renders"| node_check_icon
node_prompt_files -->|"fetches files"| node_prompt_api

click node_intro "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/introduction"
click node_techniques "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/techniques"
click node_applications "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/applications"
click node_prompt_hub "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/prompts"
click node_models "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/models"
click node_research "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/research"
click node_risks "https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/risks"
click node_datasets "https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/datasets.en.mdx"
click node_courses "https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/courses.en.mdx"
click node_theme "https://github.com/dair-ai/prompt-engineering-guide/blob/main/theme.config.tsx"
click node_app_shell "https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/_app.tsx"
click node_announcement "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/AnnouncementBar.tsx"
click node_code_view "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/pre.tsx"
click node_clipboard "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/copy-to-clipboard.tsx"
click node_button "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/button.tsx"
click node_copy_icon "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/copy.tsx"
click node_check_icon "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/check.tsx"
click node_word_wrap "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/word-wrap.tsx"
click node_page_copy "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/CopyPageDropdown.tsx"
click node_prompt_files "https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/PromptFiles.jsx"
click node_prompt_api "https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/api/promptsFiles.js"
click node_page_api "https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/api/getPageContent.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_intro,node_techniques,node_applications,node_prompt_hub,node_models,node_research,node_risks,node_datasets,node_courses toneBlue
class node_theme,node_app_shell,node_announcement toneAmber
class node_code_view,node_clipboard,node_button,node_copy_icon,node_check_icon,node_word_wrap,node_page_copy,node_prompt_files toneMint
class node_prompt_api,node_page_api toneRose
class node_reader toneIndigo
```

## Components

### Guide Content

- [Prompting Basics](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/introduction): `pages/introduction`
- [Techniques](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/techniques): `pages/techniques`
- [Applications](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/applications): `pages/applications`
- [Prompt Hub](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/prompts): `pages/prompts`
- [Model Guides](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/models): `pages/models`
- [Research Papers](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/research): `pages/research`
- [Risks](https://github.com/dair-ai/prompt-engineering-guide/tree/main/pages/risks): `pages/risks`
- [Datasets](https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/datasets.en.mdx): `pages/datasets.en.mdx`
- [Courses](https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/courses.en.mdx): `pages/courses.en.mdx`

### Site Presentation

- [Docs Theme](https://github.com/dair-ai/prompt-engineering-guide/blob/main/theme.config.tsx): `theme.config.tsx`
- [App Shell](https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/_app.tsx): `pages/_app.tsx`
- [Announcement Bar](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/AnnouncementBar.tsx): `components/AnnouncementBar.tsx`

### Reader Tools

- [Code Blocks](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/pre.tsx): `components/pre.tsx`
- [Code Clipboard](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/copy-to-clipboard.tsx): `components/copy-to-clipboard.tsx`
- [Action Button](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/button.tsx): `components/button.tsx`
- [Copy Icon](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/copy.tsx): `components/copy.tsx`
- [Copied Icon](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/check.tsx): `components/check.tsx`
- [Word Wrap Icon](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/word-wrap.tsx): `components/word-wrap.tsx`
- [Page Copy Menu](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/CopyPageDropdown.tsx): `components/CopyPageDropdown.tsx`
- [Prompt File List](https://github.com/dair-ai/prompt-engineering-guide/blob/main/components/PromptFiles.jsx): `components/PromptFiles.jsx`

### Content APIs

- [Prompt Files API](https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/api/promptsFiles.js): `pages/api/promptsFiles.js`
- [Page Content API](https://github.com/dair-ai/prompt-engineering-guide/blob/main/pages/api/getPageContent.ts): `pages/api/getPageContent.ts`

### Other components

- **Reader**

## Connections

- Reader → Prompting Basics: browses guide (evidence: `README.md`)
- Reader → Techniques: learns techniques (evidence: `README.md`)
- Reader → Applications: explores use (evidence: `README.md`)
- Reader → Prompt Hub: browses prompts (evidence: `README.md`)
- Reader → Model Guides: explores models (evidence: `README.md`)
- Reader → Research Papers: reads research (evidence: `README.md`)
- Reader → Risks: learns risks (evidence: `README.md`)
- Reader → Datasets: browses datasets (evidence: `README.md`)
- Reader → Courses: finds courses (evidence: `README.md`)
- App Shell → Announcement Bar: renders (evidence: `pages/_app.tsx`)
- Docs Theme → Page Copy Menu: renders (evidence: `theme.config.tsx`)
- Docs Theme → Code Blocks: configures (evidence: `theme.config.tsx`)
- Code Blocks → Code Clipboard: renders (evidence: `components/pre.tsx`)
- Code Blocks → Action Button: renders (evidence: `components/pre.tsx`)
- Code Blocks → Word Wrap Icon: renders (evidence: `components/pre.tsx`)
- Code Clipboard → Action Button: renders (evidence: `components/copy-to-clipboard.tsx`)
- Code Clipboard → Copy Icon: renders (evidence: `components/copy-to-clipboard.tsx`)
- Code Clipboard → Copied Icon: renders (evidence: `components/copy-to-clipboard.tsx`)
- Prompt File List → Prompt Files API: fetches files (evidence: `components/PromptFiles.jsx`)
