# kain-90/rag-play architecture

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

- Interactive diagram: https://gitdiagram.com/kain-90/rag-play
- Repository: https://github.com/kain-90/rag-play

## Overview

RAG Playground is an interactive teaching and debugging app, not a single persisted RAG service: users explore text splitting, embeddings, semantic search, and context generation in separate experiment tabs. The visible embedding runtime sends tasks to a Web Worker, stores vectors, and visualizes them; the chat API resolves a configured LLM provider. The README documents broader retrieval and generation capabilities, but their detailed wiring is not shown in the sampled source, so those links are omitted or marked unverified.

Main entry points: [`src/app/experiment/components/experiment-content.tsx`](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/experiment-content.tsx) (Experiment Tabs), [`src/app/experiment/components/embedding-tab.tsx`](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/embedding-tab.tsx) (Embedding Tab), [`src/app/experiment/page.tsx`](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/page.tsx) (Experiment Page), [`src/app/hooks/useEmbeddingWorker.ts`](https://github.com/kain-90/rag-play/blob/main/src/app/hooks/useEmbeddingWorker.ts) (Worker Hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App Experience"]
  node_experiment_page["Experiment Page<br/>[page.tsx]"]
  node_experiment_content["Experiment Tabs"]
  node_header["Header<br/>[header.tsx]"]
  node_footer["Footer<br/>[footer.tsx]"]
end

subgraph group_splitting["Text Splitting"]
  node_splitting_tab["Splitting Tab"]
  node_splitting_controls["Chunk Controls"]
  node_separator_manager["Separator Manager"]
  node_split_store["Splitting State"]
  node_split_logic["Split Logic<br/>[split-text.ts]"]
end

subgraph group_retrieval["Embeddings &amp; Retrieval"]
  node_embedding_tab["Embedding Tab<br/>[embedding-tab.tsx]"]
  node_embedding_controls["Embedding Controls"]
  node_embedding_hook["Worker Hook"]
  node_embedding_worker["Embedding Worker<br/>[embedding.ts]"]
  node_embedding_store["Embedding State<br/>[embedding-store.ts]"]
  node_semantic_tab["Semantic Search"]
  node_vector_viz["Vector Visualization"]
  node_umap["UMAP Projection<br/>[utils.ts]"]
end

subgraph group_generation["Generation"]
  node_generation_tab["Generation Tab<br/>[generation-tab.tsx]"]
  node_message_display["Message Display"]
  node_chat_api["Chat API<br/>[route.ts]"]
  node_llm_resolver["LLM Resolver<br/>[llm.ts]"]
end

node_developer(("Developer"))
node_llm_provider{{"LLM Provider"}}

node_developer -->|"opens"| node_experiment_page
node_experiment_page -->|"renders"| node_experiment_content
node_experiment_page -->|"renders"| node_header
node_experiment_page -->|"renders"| node_footer
node_experiment_content -->|"renders"| node_splitting_tab
node_experiment_content -->|"renders"| node_embedding_tab
node_experiment_content -->|"renders"| node_semantic_tab
node_experiment_content -->|"renders"| node_generation_tab
node_splitting_tab -.->|"uses controls"| node_splitting_controls
node_splitting_tab -.->|"uses state"| node_split_store
node_split_store -.->|"supplies split input"| node_split_logic
node_embedding_tab -->|"renders"| node_embedding_controls
node_embedding_tab -->|"reads state"| node_embedding_store
node_embedding_tab -->|"reads chunks"| node_split_store
node_embedding_tab -->|"renders"| node_vector_viz
node_vector_viz -->|"projects vectors"| node_umap
node_experiment_content -->|"initializes"| node_embedding_hook
node_embedding_hook -->|"posts tasks"| node_embedding_worker
node_embedding_worker -->|"sends progress"| node_embedding_hook
node_embedding_hook -->|"updates vectors"| node_embedding_store
node_semantic_tab -.->|"uses vectors"| node_embedding_store
node_generation_tab -.->|"displays messages"| node_message_display
node_generation_tab -.->|"requests response"| node_chat_api
node_chat_api -->|"resolves model"| node_llm_resolver
node_llm_resolver -->|"configures model"| node_llm_provider

click node_experiment_page "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/page.tsx"
click node_experiment_content "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/experiment-content.tsx"
click node_header "https://github.com/kain-90/rag-play/blob/main/src/app/components/header.tsx"
click node_footer "https://github.com/kain-90/rag-play/blob/main/src/app/components/footer.tsx"
click node_splitting_tab "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/text-splitting-tab.tsx"
click node_splitting_controls "https://github.com/kain-90/rag-play/tree/main/src/app/experiment/components/text-splitting"
click node_separator_manager "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/separator-manager.tsx"
click node_split_store "https://github.com/kain-90/rag-play/blob/main/src/app/stores/experiment/text-splitting-store.ts"
click node_split_logic "https://github.com/kain-90/rag-play/blob/main/src/app/utils/split-text.ts"
click node_embedding_tab "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/embedding-tab.tsx"
click node_embedding_controls "https://github.com/kain-90/rag-play/tree/main/src/app/experiment/components/embedding"
click node_embedding_hook "https://github.com/kain-90/rag-play/blob/main/src/app/hooks/useEmbeddingWorker.ts"
click node_embedding_worker "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/workers/embedding.ts"
click node_embedding_store "https://github.com/kain-90/rag-play/blob/main/src/app/stores/experiment/embedding-store.ts"
click node_semantic_tab "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/semantic-search-tab.tsx"
click node_vector_viz "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/low-vector-visualization.tsx"
click node_umap "https://github.com/kain-90/rag-play/blob/main/src/lib/utils.ts"
click node_generation_tab "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/generation-tab.tsx"
click node_message_display "https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/message-display.tsx"
click node_chat_api "https://github.com/kain-90/rag-play/blob/main/src/app/api/chat/route.ts"
click node_llm_resolver "https://github.com/kain-90/rag-play/blob/main/src/lib/llm.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_experiment_page,node_experiment_content,node_header,node_footer toneBlue
class node_splitting_tab,node_splitting_controls,node_separator_manager,node_split_store,node_split_logic toneAmber
class node_embedding_tab,node_embedding_controls,node_embedding_hook,node_embedding_worker,node_embedding_store,node_semantic_tab,node_vector_viz,node_umap toneMint
class node_generation_tab,node_message_display,node_chat_api,node_llm_resolver toneRose
class node_developer,node_llm_provider toneIndigo
```

## Components

### App Experience

- [Experiment Page](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/page.tsx): `src/app/experiment/page.tsx`
- [Experiment Tabs](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/experiment-content.tsx): `src/app/experiment/components/experiment-content.tsx`
- [Header](https://github.com/kain-90/rag-play/blob/main/src/app/components/header.tsx): `src/app/components/header.tsx`
- [Footer](https://github.com/kain-90/rag-play/blob/main/src/app/components/footer.tsx): `src/app/components/footer.tsx`

### Text Splitting

- [Splitting Tab](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/text-splitting-tab.tsx): `src/app/experiment/components/text-splitting-tab.tsx`
- [Chunk Controls](https://github.com/kain-90/rag-play/tree/main/src/app/experiment/components/text-splitting): `src/app/experiment/components/text-splitting`
- [Separator Manager](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/separator-manager.tsx): `src/app/experiment/components/separator-manager.tsx`
- [Splitting State](https://github.com/kain-90/rag-play/blob/main/src/app/stores/experiment/text-splitting-store.ts): `src/app/stores/experiment/text-splitting-store.ts`
- [Split Logic](https://github.com/kain-90/rag-play/blob/main/src/app/utils/split-text.ts): `src/app/utils/split-text.ts`

### Embeddings & Retrieval

- [Embedding Tab](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/embedding-tab.tsx): `src/app/experiment/components/embedding-tab.tsx`
- [Embedding Controls](https://github.com/kain-90/rag-play/tree/main/src/app/experiment/components/embedding): `src/app/experiment/components/embedding`
- [Worker Hook](https://github.com/kain-90/rag-play/blob/main/src/app/hooks/useEmbeddingWorker.ts): `src/app/hooks/useEmbeddingWorker.ts`
- [Embedding Worker](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/workers/embedding.ts): `src/app/experiment/workers/embedding.ts`
- [Embedding State](https://github.com/kain-90/rag-play/blob/main/src/app/stores/experiment/embedding-store.ts): `src/app/stores/experiment/embedding-store.ts`
- [Semantic Search](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/semantic-search-tab.tsx): `src/app/experiment/components/semantic-search-tab.tsx`
- [Vector Visualization](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/low-vector-visualization.tsx): `src/app/experiment/components/low-vector-visualization.tsx`
- [UMAP Projection](https://github.com/kain-90/rag-play/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Generation

- [Generation Tab](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/generation-tab.tsx): `src/app/experiment/components/generation-tab.tsx`
- [Message Display](https://github.com/kain-90/rag-play/blob/main/src/app/experiment/components/message-display.tsx): `src/app/experiment/components/message-display.tsx`
- [Chat API](https://github.com/kain-90/rag-play/blob/main/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [LLM Resolver](https://github.com/kain-90/rag-play/blob/main/src/lib/llm.ts): `src/lib/llm.ts`

### Other components

- **Developer**
- **LLM Provider**

## Connections

- Developer → Experiment Page: opens
- Experiment Page → Experiment Tabs: renders (evidence: `src/app/experiment/page.tsx`)
- Experiment Page → Header: renders (evidence: `src/app/experiment/page.tsx`)
- Experiment Page → Footer: renders (evidence: `src/app/experiment/page.tsx`)
- Experiment Tabs → Splitting Tab: renders (evidence: `src/app/experiment/components/experiment-content.tsx`)
- Experiment Tabs → Embedding Tab: renders (evidence: `src/app/experiment/components/experiment-content.tsx`)
- Experiment Tabs → Semantic Search: renders (evidence: `src/app/experiment/components/experiment-content.tsx`)
- Experiment Tabs → Generation Tab: renders (evidence: `src/app/experiment/components/experiment-content.tsx`)
- Splitting Tab → Chunk Controls: uses controls
- Splitting Tab → Splitting State: uses state
- Splitting State → Split Logic: supplies split input
- Embedding Tab → Embedding Controls: renders (evidence: `src/app/experiment/components/embedding-tab.tsx`)
- Embedding Tab → Embedding State: reads state (evidence: `src/app/experiment/components/embedding-tab.tsx`)
- Embedding Tab → Splitting State: reads chunks (evidence: `src/app/experiment/components/embedding-tab.tsx`)
- Embedding Tab → Vector Visualization: renders (evidence: `src/app/experiment/components/embedding-tab.tsx`)
- Vector Visualization → UMAP Projection: projects vectors (evidence: `src/app/experiment/components/low-vector-visualization.tsx`)
- Experiment Tabs → Worker Hook: initializes (evidence: `src/app/experiment/components/experiment-content.tsx`)
- Worker Hook → Embedding Worker: posts tasks (evidence: `src/app/hooks/useEmbeddingWorker.ts`)
- Embedding Worker → Worker Hook: sends progress (evidence: `src/app/hooks/useEmbeddingWorker.ts`)
- Worker Hook → Embedding State: updates vectors (evidence: `src/app/hooks/useEmbeddingWorker.ts`)
- Semantic Search → Embedding State: uses vectors
- Generation Tab → Message Display: displays messages
- Generation Tab → Chat API: requests response
- Chat API → LLM Resolver: resolves model (evidence: `src/app/api/chat/route.ts`)
- LLM Resolver → LLM Provider: configures model (evidence: `src/lib/llm.ts`)
