# xtraluck21/obsidian-castle architecture

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

- Interactive diagram: https://gitdiagram.com/xtraluck21/obsidian-castle
- Repository: https://github.com/xtraluck21/obsidian-castle

## Overview

CastleX is an Obsidian personal-knowledge system kit: users open its Dashboard, record Daily check-ins and project progress, then review trends and weekly summaries. The plugin implements Home, Health, and Mental views, calendar navigation, note interactions, visualizations, and study tracking; templates and a schema define reusable note structures. The README documents these capabilities and workflows, but the only sampled source is a partial excerpt of the large plugin file, so edges rely on documented relationships rather than unshown implementation details.

Main entry points: [`plugin/castlex-dashboard/main.js`](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js) (Dashboard Plugin), [`templates`](https://github.com/xtraluck21/obsidian-castle/tree/main/templates) (Note Templates), [`schemas/CastleX-Data-Schema.md`](https://github.com/xtraluck21/obsidian-castle/blob/main/schemas/CastleX-Data-Schema.md) (Data Schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dash["Dashboards"]
  node_plugin["Dashboard Plugin<br/>[main.js]"]
  node_home["Home Dashboard<br/>[main.js]"]
  node_health["Health Dashboard<br/>[main.js]"]
  node_mental["Mental Dashboard<br/>[main.js]"]
end

subgraph group_journal["Daily Journal"]
  node_daily[("Daily Notes")]
  node_calendar["Daily Calendar<br/>[main.js]"]
  node_checkin["Health Check-ins<br/>[main.js]"]
  node_navigation["Navigation Ritual<br/>[main.js]"]
end

subgraph group_insights["Reviews And Insights"]
  node_analytics["Trends And Heatmaps<br/>[main.js]"]
  node_weekly["Weekly Reviews<br/>[main.js]"]
  node_projects["Project Tracker<br/>[main.js]"]
  node_leetcode["Study Blocks<br/>[main.js]"]
end

subgraph group_kit["Note System"]
  node_templates["Note Templates"]
  node_schema["Data Schema"]
end

node_person(("Vault User"))
node_obsidian["Obsidian"]

node_person -->|"uses"| node_obsidian
node_person -->|"opens"| node_plugin
node_obsidian -->|"hosts"| node_plugin
node_plugin -->|"renders"| node_home
node_plugin -->|"renders"| node_health
node_plugin -->|"renders"| node_mental
node_home -->|"offers"| node_calendar
node_calendar -->|"opens or creates"| node_daily
node_health -->|"records"| node_checkin
node_checkin -->|"writes"| node_daily
node_home -->|"records"| node_navigation
node_mental -->|"closes voyage"| node_navigation
node_navigation -->|"stores fields"| node_daily
node_home -->|"renders"| node_analytics
node_analytics -->|"reads"| node_daily
node_plugin -->|"renders"| node_weekly
node_weekly -->|"summarizes"| node_daily
node_plugin -->|"tracks progress"| node_projects
node_plugin -->|"tracks study"| node_leetcode
node_templates -->|"structures notes"| node_daily
node_schema -->|"defines fields"| node_daily

click node_plugin "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_home "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_health "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_mental "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_calendar "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_checkin "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_navigation "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_analytics "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_weekly "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_projects "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_leetcode "https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js"
click node_templates "https://github.com/xtraluck21/obsidian-castle/tree/main/templates"
click node_schema "https://github.com/xtraluck21/obsidian-castle/blob/main/schemas/CastleX-Data-Schema.md"

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_plugin,node_home,node_health,node_mental,node_person toneBlue
class node_daily,node_calendar,node_checkin,node_navigation toneAmber
class node_analytics,node_weekly,node_projects,node_leetcode toneMint
class node_templates,node_schema toneRose
class node_obsidian toneIndigo
```

## Components

### Dashboards

- [Dashboard Plugin](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Home Dashboard](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Health Dashboard](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Mental Dashboard](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`

### Daily Journal

- **Daily Notes**
- [Daily Calendar](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Health Check-ins](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Navigation Ritual](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`

### Reviews And Insights

- [Trends And Heatmaps](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Weekly Reviews](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Project Tracker](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`
- [Study Blocks](https://github.com/xtraluck21/obsidian-castle/blob/main/plugin/castlex-dashboard/main.js): `plugin/castlex-dashboard/main.js`

### Note System

- [Note Templates](https://github.com/xtraluck21/obsidian-castle/tree/main/templates): `templates`
- [Data Schema](https://github.com/xtraluck21/obsidian-castle/blob/main/schemas/CastleX-Data-Schema.md): `schemas/CastleX-Data-Schema.md`

### Other components

- **Vault User**
- **Obsidian**

## Connections

- Vault User → Obsidian: uses (evidence: `README.md`)
- Vault User → Dashboard Plugin: opens (evidence: `README.md`)
- Obsidian → Dashboard Plugin: hosts (evidence: `README.md`)
- Dashboard Plugin → Home Dashboard: renders (evidence: `README.md`)
- Dashboard Plugin → Health Dashboard: renders (evidence: `README.md`)
- Dashboard Plugin → Mental Dashboard: renders (evidence: `README.md`)
- Home Dashboard → Daily Calendar: offers (evidence: `README.md`)
- Daily Calendar → Daily Notes: opens or creates (evidence: `README.md`)
- Health Dashboard → Health Check-ins: records (evidence: `README.md`)
- Health Check-ins → Daily Notes: writes (evidence: `README.md`)
- Home Dashboard → Navigation Ritual: records (evidence: `README.md`)
- Mental Dashboard → Navigation Ritual: closes voyage (evidence: `README.md`)
- Navigation Ritual → Daily Notes: stores fields (evidence: `README.md`)
- Home Dashboard → Trends And Heatmaps: renders (evidence: `README.md`)
- Trends And Heatmaps → Daily Notes: reads (evidence: `README.md`)
- Dashboard Plugin → Weekly Reviews: renders (evidence: `README.md`)
- Weekly Reviews → Daily Notes: summarizes (evidence: `README.md`)
- Dashboard Plugin → Project Tracker: tracks progress (evidence: `README.md`)
- Dashboard Plugin → Study Blocks: tracks study (evidence: `README.md`)
- Note Templates → Daily Notes: structures notes (evidence: `README.md`)
- Data Schema → Daily Notes: defines fields (evidence: `README.md`)
