# davila7/claude-code-templates architecture

> Architecture diagram of the GitHub repository davila7/claude-code-templates, 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/davila7/claude-code-templates
- Repository: https://github.com/davila7/claude-code-templates

## Overview

Claude Code Templates is a component catalog and CLI installer for Claude Code configuration, alongside a web catalog and local utilities. The main workflow is users selecting or specifying catalog components, then the CLI fetching and installing files while merging existing configuration; anonymous usage tracking is best-effort. The repository also contains validation, analytics and chat tools, sandbox references, and scheduled web services. The graph reflects README-described capabilities and the sampled CLI entry point; several implementation links are based on the source index rather than inspected source excerpts.

Main entry points: [`cli-tool/src/index.js`](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/index.js) (CLI entry point), [`cli-tool/src/analytics.js`](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics.js) (Session analytics), [`cli-tool/src/file-operations.js`](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/file-operations.js) (Component installer), [`cli-tool/components`](https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components) (Component catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog and discovery"]
  node_catalog[("Component catalog")]
  node_browse["Catalog browser<br/>[catalog-browser.js]"]
  node_lookup["Catalog lookup<br/>[catalog-lookup.js]"]
end

subgraph group_cli["CLI installation"]
  node_cli["CLI entry point<br/>[index.js]"]
  node_install["Component installer<br/>[file-operations.js]"]
  node_merge["Config merging<br/>[merge.rs]"]
  node_rust["Rust CLI core<br/>[main.rs]"]
  node_tracking["Usage tracking"]
  node_validation["Component validation"]
  node_sandboxes["Sandbox references"]
end

subgraph group_local["Local tools"]
  node_analytics["Session analytics<br/>[analytics.js]"]
  node_analyzer["Session analysis<br/>[SessionAnalyzer.js]"]
  node_notifications["Live notifications"]
  node_chats["Chat browser<br/>[chats-mobile.js]"]
  node_health["Health check<br/>[health-check.js]"]
end

subgraph group_web["Web services"]
  node_dashboard["Catalog website"]
  node_tracking_api["Tracking endpoints"]
  node_cron["Scheduled checks<br/>[index.js]"]
  node_pulse["Weekly KPI report<br/>[index.js]"]
  node_newsletter["Community newsletter<br/>[index.js]"]
  node_docs_monitor["Docs monitor<br/>[index.js]"]
end

node_user(("CLI user"))

node_user -->|"selects components"| node_cli
node_user -->|"browses catalog"| node_browse
node_browse -.->|"searches"| node_catalog
node_cli -->|"looks up components"| node_lookup
node_cli -->|"installs files"| node_install
node_install -->|"merges config"| node_merge
node_rust -->|"delegates non-install work"| node_install
node_cli -->|"reports usage"| node_tracking
node_tracking -->|"sends tracking requests"| node_tracking_api
node_validation -.->|"validates components"| node_catalog
node_user -->|"runs analytics"| node_analytics
node_analytics -->|"analyzes sessions"| node_analyzer
node_analytics -->|"manages notifications"| node_notifications
node_user -->|"opens chat browser"| node_chats
node_user -->|"runs diagnostics"| node_health
node_user -->|"uses sandbox references"| node_sandboxes
node_user -->|"browses catalog"| node_dashboard
node_cron -->|"triggers health check"| node_health
node_pulse -.->|"collects usage metrics"| node_tracking_api
node_newsletter -.->|"selects trending components"| node_catalog
node_docs_monitor -.->|"monitors documentation"| node_dashboard

click node_catalog "https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components"
click node_browse "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/catalog-browser.js"
click node_lookup "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/catalog-lookup.js"
click node_cli "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/index.js"
click node_install "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/file-operations.js"
click node_merge "https://github.com/davila7/claude-code-templates/blob/main/cli-rust/src/merge.rs"
click node_rust "https://github.com/davila7/claude-code-templates/blob/main/cli-rust/src/main.rs"
click node_tracking "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/tracking-service.js"
click node_validation "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/validation/ValidationOrchestrator.js"
click node_analytics "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics.js"
click node_analyzer "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics/core/SessionAnalyzer.js"
click node_notifications "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics/notifications/NotificationManager.js"
click node_chats "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/chats-mobile.js"
click node_health "https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/health-check.js"
click node_sandboxes "https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/sandbox"
click node_dashboard "https://github.com/davila7/claude-code-templates/tree/main/dashboard"
click node_tracking_api "https://github.com/davila7/claude-code-templates/blob/main/dashboard/src/lib/api/download-client-signals.ts"
click node_cron "https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/crons/index.js"
click node_pulse "https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/pulse/index.js"
click node_newsletter "https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/newsletter/index.js"
click node_docs_monitor "https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/docs-monitor/index.js"

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_catalog,node_browse,node_lookup,node_user toneBlue
class node_cli,node_install,node_merge,node_rust,node_tracking,node_validation,node_sandboxes toneAmber
class node_analytics,node_analyzer,node_notifications,node_chats,node_health toneMint
class node_dashboard,node_tracking_api,node_cron,node_pulse,node_newsletter,node_docs_monitor toneRose
```

## Components

### Catalog and discovery

- [Component catalog](https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components): `cli-tool/components`
- [Catalog browser](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/catalog-browser.js): `cli-tool/src/catalog-browser.js`
- [Catalog lookup](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/catalog-lookup.js): `cli-tool/src/catalog-lookup.js`

### CLI installation

- [CLI entry point](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/index.js): `cli-tool/src/index.js`
- [Component installer](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/file-operations.js): `cli-tool/src/file-operations.js`
- [Config merging](https://github.com/davila7/claude-code-templates/blob/main/cli-rust/src/merge.rs): `cli-rust/src/merge.rs`
- [Rust CLI core](https://github.com/davila7/claude-code-templates/blob/main/cli-rust/src/main.rs): `cli-rust/src/main.rs`
- [Usage tracking](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/tracking-service.js): `cli-tool/src/tracking-service.js`
- [Component validation](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/validation/ValidationOrchestrator.js): `cli-tool/src/validation/ValidationOrchestrator.js`
- [Sandbox references](https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/sandbox): `cli-tool/components/sandbox`

### Local tools

- [Session analytics](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics.js): `cli-tool/src/analytics.js`
- [Session analysis](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics/core/SessionAnalyzer.js): `cli-tool/src/analytics/core/SessionAnalyzer.js`
- [Live notifications](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/analytics/notifications/NotificationManager.js): `cli-tool/src/analytics/notifications/NotificationManager.js`
- [Chat browser](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/chats-mobile.js): `cli-tool/src/chats-mobile.js`
- [Health check](https://github.com/davila7/claude-code-templates/blob/main/cli-tool/src/health-check.js): `cli-tool/src/health-check.js`

### Web services

- [Catalog website](https://github.com/davila7/claude-code-templates/tree/main/dashboard): `dashboard`
- [Tracking endpoints](https://github.com/davila7/claude-code-templates/blob/main/dashboard/src/lib/api/download-client-signals.ts): `dashboard/src/lib/api/download-client-signals.ts`
- [Scheduled checks](https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/crons/index.js): `cloudflare-workers/crons/index.js`
- [Weekly KPI report](https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/pulse/index.js): `cloudflare-workers/pulse/index.js`
- [Community newsletter](https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/newsletter/index.js): `cloudflare-workers/newsletter/index.js`
- [Docs monitor](https://github.com/davila7/claude-code-templates/blob/main/cloudflare-workers/docs-monitor/index.js): `cloudflare-workers/docs-monitor/index.js`

### Other components

- **CLI user**

## Connections

- CLI user → CLI entry point: selects components (evidence: `README.md`)
- CLI user → Catalog browser: browses catalog (evidence: `README.md`)
- Catalog browser → Component catalog: searches
- CLI entry point → Catalog lookup: looks up components (evidence: `cli-tool/src/index.js`)
- CLI entry point → Component installer: installs files (evidence: `cli-tool/src/index.js`)
- Component installer → Config merging: merges config (evidence: `README.md`)
- Rust CLI core → Component installer: delegates non-install work (evidence: `cli-rust/src/main.rs`)
- CLI entry point → Usage tracking: reports usage (evidence: `cli-tool/src/index.js`)
- Usage tracking → Tracking endpoints: sends tracking requests (evidence: `cli-tool/src/tracking-service.js`)
- Component validation → Component catalog: validates components
- CLI user → Session analytics: runs analytics (evidence: `README.md`)
- Session analytics → Session analysis: analyzes sessions (evidence: `cli-tool/src/analytics.js`)
- Session analytics → Live notifications: manages notifications (evidence: `cli-tool/src/analytics.js`)
- CLI user → Chat browser: opens chat browser (evidence: `README.md`)
- CLI user → Health check: runs diagnostics (evidence: `README.md`)
- CLI user → Sandbox references: uses sandbox references (evidence: `README.md`)
- CLI user → Catalog website: browses catalog (evidence: `README.md`)
- Scheduled checks → Health check: triggers health check (evidence: `cloudflare-workers/crons/index.js`)
- Weekly KPI report → Tracking endpoints: collects usage metrics
- Community newsletter → Component catalog: selects trending components
- Docs monitor → Catalog website: monitors documentation
