# walkxcode/dashboard-icons architecture

> Architecture diagram of the GitHub repository walkxcode/dashboard-icons, 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/walkxcode/dashboard-icons
- Repository: https://github.com/walkxcode/dashboard-icons

## Overview

Dashboard Icons combines a curated icon catalogue with a website for discovery and downloads, community submissions and review, external icon collections, and an MCP interface for AI clients. The main user journey is browse or search, inspect an icon, then download or copy its link; contributors can submit icons for review and publication. The README documents these capabilities, while sampled source confirms selected review, PocketBase, MCP, and external-icon relationships. Several page and service implementations were not sampled, so undocumented internal connections are omitted.

Main entry points: [`web/src/components/dashboard/review-bench.tsx`](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/review-bench.tsx) (Review Bench), [`web/src/app`](https://github.com/walkxcode/dashboard-icons/tree/main/web/src/app) (Website Pages), [`web/src/app/api/mcp/route.ts`](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/mcp/route.ts) (MCP Endpoint), [`web/src/app/actions/submissions.ts`](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/actions/submissions.ts) (Submission Actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalogue["Icon Catalogue"]
  node_website["Website Pages"]
  node_iconsearch["Icon Search<br/>[icon-search.tsx]"]
  node_iconapi["Search API<br/>[route.ts]"]
  node_iconservice["Icon Services<br/>[service.ts]"]
  node_iconpages["Icon Details<br/>[page.tsx]"]
  node_ogimage["Social Previews<br/>[route.tsx]"]
end

subgraph group_community["Community Workflow"]
  node_submissionform["Submission Form"]
  node_submissionactions["Submission Actions<br/>[submissions.ts]"]
  node_reviewbench["Review Bench<br/>[review-bench.tsx]"]
  node_reviewlist["Submission List"]
  node_reviewgallery["Review Gallery<br/>[review-gallery.tsx]"]
  node_dashboardhooks["Dashboard Hooks<br/>[dashboard.js]"]
end

subgraph group_integrations["External Integrations"]
  node_externalcatalog["External Catalogue<br/>[external-icons.ts]"]
  node_externalpage["External Icon Pages<br/>[page.tsx]"]
  node_externalroute["Simple Icons Proxy<br/>[route.tsx]"]
  node_mcproute["MCP Endpoint<br/>[route.ts]"]
  node_mcphandler["MCP Handler<br/>[handler.ts]"]
  node_mcpanalytics["MCP Analytics<br/>[analytics.ts]"]
end

subgraph group_platform["Application Platform"]
  node_pocketbase[("PocketBase<br/>[pb.ts]")]
end

node_visitor(("Icon Seeker"))
node_contributor(("Contributor"))
node_mcpclient(("MCP Client"))

node_visitor -->|"browses"| node_website
node_website -->|"offers search"| node_iconsearch
node_iconsearch -.->|"searches"| node_iconapi
node_iconapi -.->|"queries"| node_iconservice
node_website -->|"opens details"| node_iconpages
node_iconpages -.->|"generates preview"| node_ogimage
node_contributor -->|"submits icon"| node_submissionform
node_submissionform -.->|"sends submission"| node_submissionactions
node_submissionactions -.->|"stores submission"| node_pocketbase
node_reviewbench -->|"requests review"| node_dashboardhooks
node_reviewbench -->|"revalidates queue"| node_submissionactions
node_reviewbench -->|"uses list"| node_reviewlist
node_reviewbench -->|"uses gallery"| node_reviewgallery
node_reviewgallery -->|"gets file URLs"| node_pocketbase
node_dashboardhooks -.->|"updates records"| node_pocketbase
node_visitor -->|"browses external icons"| node_externalpage
node_externalpage -.->|"loads icon"| node_externalcatalog
node_externalroute -.->|"serves variant"| node_externalcatalog
node_mcpclient -->|"calls tools"| node_mcproute
node_mcproute -->|"dispatches request"| node_mcphandler
node_mcproute -->|"flushes analytics"| node_mcpanalytics

click node_website "https://github.com/walkxcode/dashboard-icons/tree/main/web/src/app"
click node_iconsearch "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/icon-search.tsx"
click node_iconapi "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/icons/search/route.ts"
click node_iconservice "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/icons/service.ts"
click node_iconpages "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/icons/%5Bicon%5D/page.tsx"
click node_ogimage "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/og/%5Bicon%5D/route.tsx"
click node_submissionform "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/icon-submission-form.tsx"
click node_submissionactions "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/actions/submissions.ts"
click node_reviewbench "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/review-bench.tsx"
click node_reviewlist "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/submission-list.tsx"
click node_reviewgallery "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/review-gallery.tsx"
click node_dashboardhooks "https://github.com/walkxcode/dashboard-icons/blob/main/web/backend/pb_hooks/dashboard.js"
click node_pocketbase "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/pb.ts"
click node_externalcatalog "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/external-icons.ts"
click node_externalpage "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/icons/external/%5Bslug%5D/page.tsx"
click node_externalroute "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/icons/external/simpleicons/%5Bslug%5D/%5Bvariant%5D/route.tsx"
click node_mcproute "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/mcp/route.ts"
click node_mcphandler "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/mcp/handler.ts"
click node_mcpanalytics "https://github.com/walkxcode/dashboard-icons/blob/main/web/src/mcp/analytics.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_website,node_iconsearch,node_iconapi,node_iconservice,node_iconpages,node_ogimage,node_mcpclient toneBlue
class node_submissionform,node_submissionactions,node_reviewbench,node_reviewlist,node_reviewgallery,node_dashboardhooks toneAmber
class node_externalcatalog,node_externalpage,node_externalroute,node_mcproute,node_mcphandler,node_mcpanalytics toneMint
class node_pocketbase toneRose
class node_visitor,node_contributor toneIndigo
```

## Components

### Icon Catalogue

- [Website Pages](https://github.com/walkxcode/dashboard-icons/tree/main/web/src/app): `web/src/app`
- [Icon Search](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/icon-search.tsx): `web/src/components/icon-search.tsx`
- [Search API](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/icons/search/route.ts): `web/src/app/api/icons/search/route.ts`
- [Icon Services](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/icons/service.ts): `web/src/lib/icons/service.ts`
- [Icon Details](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/icons/%5Bicon%5D/page.tsx): `web/src/app/icons/[icon]/page.tsx`
- [Social Previews](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/og/%5Bicon%5D/route.tsx): `web/src/app/og/[icon]/route.tsx`

### Community Workflow

- [Submission Form](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/icon-submission-form.tsx): `web/src/components/icon-submission-form.tsx`
- [Submission Actions](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/actions/submissions.ts): `web/src/app/actions/submissions.ts`
- [Review Bench](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/review-bench.tsx): `web/src/components/dashboard/review-bench.tsx`
- [Submission List](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/submission-list.tsx): `web/src/components/dashboard/submission-list.tsx`
- [Review Gallery](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/components/dashboard/review-gallery.tsx): `web/src/components/dashboard/review-gallery.tsx`
- [Dashboard Hooks](https://github.com/walkxcode/dashboard-icons/blob/main/web/backend/pb_hooks/dashboard.js): `web/backend/pb_hooks/dashboard.js`

### External Integrations

- [External Catalogue](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/external-icons.ts): `web/src/lib/external-icons.ts`
- [External Icon Pages](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/icons/external/%5Bslug%5D/page.tsx): `web/src/app/icons/external/[slug]/page.tsx`
- [Simple Icons Proxy](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/icons/external/simpleicons/%5Bslug%5D/%5Bvariant%5D/route.tsx): `web/src/app/api/icons/external/simpleicons/[slug]/[variant]/route.tsx`
- [MCP Endpoint](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/app/api/mcp/route.ts): `web/src/app/api/mcp/route.ts`
- [MCP Handler](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/mcp/handler.ts): `web/src/mcp/handler.ts`
- [MCP Analytics](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/mcp/analytics.ts): `web/src/mcp/analytics.ts`

### Application Platform

- [PocketBase](https://github.com/walkxcode/dashboard-icons/blob/main/web/src/lib/pb.ts): `web/src/lib/pb.ts`

### Other components

- **Icon Seeker**
- **Contributor**
- **MCP Client**

## Connections

- Icon Seeker → Website Pages: browses
- Website Pages → Icon Search: offers search
- Icon Search → Search API: searches
- Search API → Icon Services: queries
- Website Pages → Icon Details: opens details
- Icon Details → Social Previews: generates preview
- Contributor → Submission Form: submits icon
- Submission Form → Submission Actions: sends submission
- Submission Actions → PocketBase: stores submission
- Review Bench → Dashboard Hooks: requests review (evidence: `web/src/components/dashboard/review-bench.tsx`)
- Review Bench → Submission Actions: revalidates queue (evidence: `web/src/components/dashboard/review-bench.tsx`)
- Review Bench → Submission List: uses list (evidence: `web/src/components/dashboard/review-bench.tsx`)
- Review Bench → Review Gallery: uses gallery (evidence: `web/src/components/dashboard/review-bench.tsx`)
- Review Gallery → PocketBase: gets file URLs (evidence: `web/src/components/dashboard/review-gallery.tsx`)
- Dashboard Hooks → PocketBase: updates records
- Icon Seeker → External Icon Pages: browses external icons
- External Icon Pages → External Catalogue: loads icon
- Simple Icons Proxy → External Catalogue: serves variant
- MCP Client → MCP Endpoint: calls tools
- MCP Endpoint → MCP Handler: dispatches request (evidence: `web/src/app/api/mcp/route.ts`)
- MCP Endpoint → MCP Analytics: flushes analytics (evidence: `web/src/app/api/mcp/route.ts`)
