# andrealo20/crest architecture

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

- Interactive diagram: https://gitdiagram.com/andrealo20/crest
- Repository: https://github.com/andrealo20/crest

## Overview

Crest is a Windows/macOS desktop Dynamic Island: users open the notch, choose tools, and use its compact row, notices, and expanded panels to reach system and productivity features. The map emphasizes the notch runtime, its tool families, settings and persistence, and native services. README statements support the feature branches; sampled startup and service excerpts support only the shown runtime links. The Rust command boundary is suggested by native invokes and the Rust module registry, but its specific routing is not established by the excerpts.

Main entry points: [`src/notch/Notch.tsx`](https://github.com/andrealo20/crest/blob/main/src/notch/Notch.tsx) (Notch interface), [`src/platform/services.ts`](https://github.com/andrealo20/crest/blob/main/src/platform/services.ts) (Native service API), [`src/main.tsx`](https://github.com/andrealo20/crest/blob/main/src/main.tsx) (App startup), [`src/features/now-playing/NowPlayingView.tsx`](https://github.com/andrealo20/crest/blob/main/src/features/now-playing/NowPlayingView.tsx) (Music and lyrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Notch runtime"]
  node_startup["App startup<br/>[main.tsx]"]
  node_notch["Notch interface<br/>[Notch.tsx]"]
  node_closedrow["Closed row<br/>[collapsed.ts]"]
  node_notices["Notices<br/>[store.ts]"]
end

subgraph group_tools["User tools"]
  node_nowplaying["Music and lyrics<br/>[NowPlayingView.tsx]"]
  node_calendar["Calendar<br/>[CalendarView.tsx]"]
  node_focus["Timer and focus<br/>[TimerView.tsx]"]
  node_productivity["Productivity tools<br/>[TodosView.tsx]"]
  node_capture["Capture and clipboard<br/>[CaptureView.tsx]"]
  node_launcher["Launcher<br/>[LauncherView.tsx]"]
  node_overview["Overview<br/>[OverviewView.tsx]"]
end

subgraph group_system["System features"]
  node_systemview["System monitoring<br/>[SystemView.tsx]"]
  node_privacy["Privacy indicators<br/>[PrivacyDots.tsx]"]
  node_plugins["Plugin tools<br/>[PluginView.tsx]"]
end

subgraph group_platform["Platform services"]
  node_services["Native service API<br/>[services.ts]"]
  node_bridge["Window bridge<br/>[tauriTransport.ts]"]
  node_rust["Rust desktop backend<br/>[lib.rs]"]
  node_translation["Offline translation<br/>[offlineEngine.ts]"]
end

subgraph group_state["Settings and state"]
  node_settings[("Settings<br/>[store.ts]")]
  node_store[("Shared state<br/>[store.ts]")]
end

node_user(("Desktop user"))

node_user -->|"opens and uses"| node_notch
node_startup -->|"renders"| node_notch
node_notch -->|"shows"| node_closedrow
node_notch -->|"shows notices"| node_notices
node_notch -->|"offers tool"| node_nowplaying
node_notch -->|"offers tool"| node_calendar
node_notch -->|"offers tool"| node_focus
node_notch -->|"offers tools"| node_productivity
node_notch -->|"offers tools"| node_capture
node_notch -->|"offers tool"| node_launcher
node_notch -->|"offers view"| node_overview
node_notch -->|"shows status"| node_systemview
node_notch -->|"shows indicators"| node_privacy
node_notch -->|"offers tools"| node_plugins
node_startup -->|"starts language"| node_settings
node_settings -->|"persists through"| node_store
node_notch -.->|"uses platform API"| node_services
node_services -.->|"invokes native commands"| node_rust
node_notch -.->|"coordinates windows"| node_bridge
node_nowplaying -->|"translates lyrics"| node_translation
node_translation -->|"loads model files"| node_services

click node_startup "https://github.com/andrealo20/crest/blob/main/src/main.tsx"
click node_notch "https://github.com/andrealo20/crest/blob/main/src/notch/Notch.tsx"
click node_closedrow "https://github.com/andrealo20/crest/blob/main/src/notch/collapsed.ts"
click node_notices "https://github.com/andrealo20/crest/blob/main/src/features/notices/store.ts"
click node_nowplaying "https://github.com/andrealo20/crest/blob/main/src/features/now-playing/NowPlayingView.tsx"
click node_calendar "https://github.com/andrealo20/crest/blob/main/src/features/calendar/CalendarView.tsx"
click node_focus "https://github.com/andrealo20/crest/blob/main/src/features/timer/TimerView.tsx"
click node_productivity "https://github.com/andrealo20/crest/blob/main/src/features/todos/TodosView.tsx"
click node_capture "https://github.com/andrealo20/crest/blob/main/src/features/capture/CaptureView.tsx"
click node_launcher "https://github.com/andrealo20/crest/blob/main/src/features/launcher/LauncherView.tsx"
click node_overview "https://github.com/andrealo20/crest/blob/main/src/features/overview/OverviewView.tsx"
click node_systemview "https://github.com/andrealo20/crest/blob/main/src/features/system/SystemView.tsx"
click node_privacy "https://github.com/andrealo20/crest/blob/main/src/features/privacy/PrivacyDots.tsx"
click node_plugins "https://github.com/andrealo20/crest/blob/main/src/features/plugins/PluginView.tsx"
click node_settings "https://github.com/andrealo20/crest/blob/main/src/settings/store.ts"
click node_store "https://github.com/andrealo20/crest/blob/main/src/lib/store.ts"
click node_services "https://github.com/andrealo20/crest/blob/main/src/platform/services.ts"
click node_bridge "https://github.com/andrealo20/crest/blob/main/src/lib/tauriTransport.ts"
click node_rust "https://github.com/andrealo20/crest/blob/main/src-tauri/src/lib.rs"
click node_translation "https://github.com/andrealo20/crest/blob/main/src/features/now-playing/offlineEngine.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_startup,node_notch,node_closedrow,node_notices,node_user toneBlue
class node_nowplaying,node_calendar,node_focus,node_productivity,node_capture,node_launcher,node_overview toneAmber
class node_systemview,node_privacy,node_plugins toneMint
class node_services,node_bridge,node_rust,node_translation toneRose
class node_settings,node_store toneIndigo
```

## Components

### Notch runtime

- [App startup](https://github.com/andrealo20/crest/blob/main/src/main.tsx): `src/main.tsx`
- [Notch interface](https://github.com/andrealo20/crest/blob/main/src/notch/Notch.tsx): `src/notch/Notch.tsx`
- [Closed row](https://github.com/andrealo20/crest/blob/main/src/notch/collapsed.ts): `src/notch/collapsed.ts`
- [Notices](https://github.com/andrealo20/crest/blob/main/src/features/notices/store.ts): `src/features/notices/store.ts`

### User tools

- [Music and lyrics](https://github.com/andrealo20/crest/blob/main/src/features/now-playing/NowPlayingView.tsx): `src/features/now-playing/NowPlayingView.tsx`
- [Calendar](https://github.com/andrealo20/crest/blob/main/src/features/calendar/CalendarView.tsx): `src/features/calendar/CalendarView.tsx`
- [Timer and focus](https://github.com/andrealo20/crest/blob/main/src/features/timer/TimerView.tsx): `src/features/timer/TimerView.tsx`
- [Productivity tools](https://github.com/andrealo20/crest/blob/main/src/features/todos/TodosView.tsx): `src/features/todos/TodosView.tsx`
- [Capture and clipboard](https://github.com/andrealo20/crest/blob/main/src/features/capture/CaptureView.tsx): `src/features/capture/CaptureView.tsx`
- [Launcher](https://github.com/andrealo20/crest/blob/main/src/features/launcher/LauncherView.tsx): `src/features/launcher/LauncherView.tsx`
- [Overview](https://github.com/andrealo20/crest/blob/main/src/features/overview/OverviewView.tsx): `src/features/overview/OverviewView.tsx`

### System features

- [System monitoring](https://github.com/andrealo20/crest/blob/main/src/features/system/SystemView.tsx): `src/features/system/SystemView.tsx`
- [Privacy indicators](https://github.com/andrealo20/crest/blob/main/src/features/privacy/PrivacyDots.tsx): `src/features/privacy/PrivacyDots.tsx`
- [Plugin tools](https://github.com/andrealo20/crest/blob/main/src/features/plugins/PluginView.tsx): `src/features/plugins/PluginView.tsx`

### Platform services

- [Native service API](https://github.com/andrealo20/crest/blob/main/src/platform/services.ts): `src/platform/services.ts`
- [Window bridge](https://github.com/andrealo20/crest/blob/main/src/lib/tauriTransport.ts): `src/lib/tauriTransport.ts`
- [Rust desktop backend](https://github.com/andrealo20/crest/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Offline translation](https://github.com/andrealo20/crest/blob/main/src/features/now-playing/offlineEngine.ts): `src/features/now-playing/offlineEngine.ts`

### Settings and state

- [Settings](https://github.com/andrealo20/crest/blob/main/src/settings/store.ts): `src/settings/store.ts`
- [Shared state](https://github.com/andrealo20/crest/blob/main/src/lib/store.ts): `src/lib/store.ts`

### Other components

- **Desktop user**

## Connections

- Desktop user → Notch interface: opens and uses (evidence: `README.md`)
- App startup → Notch interface: renders (evidence: `src/main.tsx`)
- Notch interface → Closed row: shows (evidence: `README.md`)
- Notch interface → Notices: shows notices (evidence: `README.md`)
- Notch interface → Music and lyrics: offers tool (evidence: `README.md`)
- Notch interface → Calendar: offers tool (evidence: `README.md`)
- Notch interface → Timer and focus: offers tool (evidence: `README.md`)
- Notch interface → Productivity tools: offers tools (evidence: `README.md`)
- Notch interface → Capture and clipboard: offers tools (evidence: `README.md`)
- Notch interface → Launcher: offers tool (evidence: `README.md`)
- Notch interface → Overview: offers view (evidence: `README.md`)
- Notch interface → System monitoring: shows status (evidence: `README.md`)
- Notch interface → Privacy indicators: shows indicators (evidence: `README.md`)
- Notch interface → Plugin tools: offers tools (evidence: `README.md`)
- App startup → Settings: starts language (evidence: `src/main.tsx`)
- Settings → Shared state: persists through (evidence: `src/settings/store.ts`)
- Notch interface → Native service API: uses platform API
- Native service API → Rust desktop backend: invokes native commands
- Notch interface → Window bridge: coordinates windows
- Music and lyrics → Offline translation: translates lyrics (evidence: `README.md`)
- Offline translation → Native service API: loads model files (evidence: `src/features/now-playing/offlineEngine.ts`)
