# boris-boomer/shipsignal architecture

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

- Interactive diagram: https://gitdiagram.com/boris-boomer/shipsignal
- Repository: https://github.com/boris-boomer/shipsignal

## Overview

ShipSignal is a local-first desktop decision companion for indie developers. Users create projects, capture evidence such as signals and conversions, record decisions, then review patterns and a daily suggested action; project outcomes can be archived with reusable lessons. The dashboard summarizes activity across projects, while optional AI drafts or summarizes content from project history without making decisions. The graph follows the documented capabilities and sampled routing, retrieval, review, and Tauri wiring; some feature-to-storage links are omitted where source excerpts do not establish the callers.

Main entry points: [`src/lib/db.ts`](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/db.ts) (Local Data Access), [`src/app/router.tsx`](https://github.com/boris-boomer/shipsignal/blob/main/src/app/router.tsx) (App Router), [`src/features/ai/AiPage.tsx`](https://github.com/boris-boomer/shipsignal/blob/main/src/features/ai/AiPage.tsx) (AI Assistant), [`src/features/projects/ArchiveReview.tsx`](https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/ArchiveReview.tsx) (Archive Review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product_flow["Project Evidence &amp; Review"]
  node_router["App Router<br/>[router.tsx]"]
  node_onboarding["Project Setup<br/>[OnboardingPage.tsx]"]
  node_project_detail["Project Records"]
  node_archive_review["Archive Review<br/>[ArchiveReview.tsx]"]
  node_harbor["Archived Projects<br/>[HarborPage.tsx]"]
  node_feeds["Signal Feeds<br/>[index.ts]"]
  node_rss_sources["RSS Sources"]
end

subgraph group_guidance["Insights &amp; Guidance"]
  node_signal_patterns["Signal Patterns<br/>[signalPatterns.ts]"]
  node_today["Daily Action<br/>[TodayPage.tsx]"]
  node_dashboard["Portfolio Dashboard<br/>[DashboardPage.tsx]"]
  node_dashboard_data["Dashboard Metrics"]
end

subgraph group_ai["AI Assistance"]
  node_ai_page["AI Assistant<br/>[AiPage.tsx]"]
  node_ai_context["Project Context<br/>[aiContext.ts]"]
  node_rag["Related History<br/>[retriever.ts]"]
  node_ai_service["AI Service<br/>[ai.ts]"]
end

subgraph group_desktop["Desktop &amp; Storage"]
  node_db_api["Local Data Access<br/>[db.ts]"]
  node_sqlite[("Local SQLite<br/>[db.ts]")]
  node_tauri["Tauri Runtime<br/>[lib.rs]"]
  node_rust_commands["Native Commands<br/>[mod.rs]"]
end

node_user(("Developer"))
node_external_ai{{"Configured AI Provider"}}

node_user -->|"opens app"| node_router
node_router -->|"routes setup"| node_onboarding
node_router -->|"routes project"| node_project_detail
node_router -->|"opens home"| node_today
node_router -->|"routes dashboard"| node_dashboard
node_router -->|"routes harbor"| node_harbor
node_project_detail -->|"reviews archive"| node_archive_review
node_rss_sources -->|"manages sources"| node_db_api
node_feeds -->|"reads feed data"| node_db_api
node_dashboard -->|"loads metrics"| node_dashboard_data
node_dashboard_data -->|"reads signals, conversions"| node_db_api
node_archive_review -->|"loads and saves"| node_db_api
node_archive_review -->|"archives projects"| node_harbor
node_today -->|"uses patterns"| node_signal_patterns
node_signal_patterns -->|"reads signal history"| node_db_api
node_ai_page -->|"builds context"| node_ai_context
node_ai_context -->|"reads project history"| node_db_api
node_ai_page -->|"retrieves related history"| node_rag
node_rag -->|"reads signals, decisions"| node_db_api
node_ai_page -->|"requests AI"| node_ai_service
node_ai_service -.->|"sends prompt"| node_external_ai
node_db_api -->|"reads and writes"| node_sqlite
node_tauri -->|"registers commands"| node_rust_commands
node_tauri -->|"enables SQL plugin"| node_sqlite

click node_router "https://github.com/boris-boomer/shipsignal/blob/main/src/app/router.tsx"
click node_onboarding "https://github.com/boris-boomer/shipsignal/blob/main/src/features/onboarding/OnboardingPage.tsx"
click node_project_detail "https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/ProjectDetailPage.tsx"
click node_signal_patterns "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/signalPatterns.ts"
click node_today "https://github.com/boris-boomer/shipsignal/blob/main/src/features/today/TodayPage.tsx"
click node_dashboard "https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/DashboardPage.tsx"
click node_dashboard_data "https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/dashboard/useDashboardData.ts"
click node_archive_review "https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/ArchiveReview.tsx"
click node_harbor "https://github.com/boris-boomer/shipsignal/blob/main/src/features/harbor/HarborPage.tsx"
click node_feeds "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/feeds/index.ts"
click node_rss_sources "https://github.com/boris-boomer/shipsignal/blob/main/src/features/settings/RssSourceManager.tsx"
click node_ai_page "https://github.com/boris-boomer/shipsignal/blob/main/src/features/ai/AiPage.tsx"
click node_ai_context "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/aiContext.ts"
click node_rag "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/rag/retriever.ts"
click node_ai_service "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/ai.ts"
click node_db_api "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/db.ts"
click node_sqlite "https://github.com/boris-boomer/shipsignal/blob/main/src/lib/db.ts"
click node_tauri "https://github.com/boris-boomer/shipsignal/blob/main/src-tauri/src/lib.rs"
click node_rust_commands "https://github.com/boris-boomer/shipsignal/blob/main/src-tauri/src/commands/mod.rs"

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_router,node_onboarding,node_project_detail,node_archive_review,node_harbor,node_feeds,node_rss_sources toneBlue
class node_signal_patterns,node_today,node_dashboard,node_dashboard_data toneAmber
class node_ai_page,node_ai_context,node_rag,node_ai_service toneMint
class node_db_api,node_sqlite,node_tauri,node_rust_commands toneRose
class node_user,node_external_ai toneIndigo
```

## Components

### Project Evidence & Review

- [App Router](https://github.com/boris-boomer/shipsignal/blob/main/src/app/router.tsx): `src/app/router.tsx`
- [Project Setup](https://github.com/boris-boomer/shipsignal/blob/main/src/features/onboarding/OnboardingPage.tsx): `src/features/onboarding/OnboardingPage.tsx`
- [Project Records](https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/ProjectDetailPage.tsx): `src/features/projects/ProjectDetailPage.tsx`
- [Archive Review](https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/ArchiveReview.tsx): `src/features/projects/ArchiveReview.tsx`
- [Archived Projects](https://github.com/boris-boomer/shipsignal/blob/main/src/features/harbor/HarborPage.tsx): `src/features/harbor/HarborPage.tsx`
- [Signal Feeds](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/feeds/index.ts): `src/lib/feeds/index.ts`
- [RSS Sources](https://github.com/boris-boomer/shipsignal/blob/main/src/features/settings/RssSourceManager.tsx): `src/features/settings/RssSourceManager.tsx`

### Insights & Guidance

- [Signal Patterns](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/signalPatterns.ts): `src/lib/signalPatterns.ts`
- [Daily Action](https://github.com/boris-boomer/shipsignal/blob/main/src/features/today/TodayPage.tsx): `src/features/today/TodayPage.tsx`
- [Portfolio Dashboard](https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/DashboardPage.tsx): `src/features/projects/DashboardPage.tsx`
- [Dashboard Metrics](https://github.com/boris-boomer/shipsignal/blob/main/src/features/projects/dashboard/useDashboardData.ts): `src/features/projects/dashboard/useDashboardData.ts`

### AI Assistance

- [AI Assistant](https://github.com/boris-boomer/shipsignal/blob/main/src/features/ai/AiPage.tsx): `src/features/ai/AiPage.tsx`
- [Project Context](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/aiContext.ts): `src/lib/aiContext.ts`
- [Related History](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/rag/retriever.ts): `src/lib/rag/retriever.ts`
- [AI Service](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/ai.ts): `src/lib/ai.ts`

### Desktop & Storage

- [Local Data Access](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Local SQLite](https://github.com/boris-boomer/shipsignal/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Tauri Runtime](https://github.com/boris-boomer/shipsignal/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Native Commands](https://github.com/boris-boomer/shipsignal/blob/main/src-tauri/src/commands/mod.rs): `src-tauri/src/commands/mod.rs`

### Other components

- **Developer**
- **Configured AI Provider**

## Connections

- Developer → App Router: opens app
- App Router → Project Setup: routes setup
- App Router → Project Records: routes project
- App Router → Daily Action: opens home
- App Router → Portfolio Dashboard: routes dashboard
- App Router → Archived Projects: routes harbor
- Project Records → Archive Review: reviews archive
- RSS Sources → Local Data Access: manages sources
- Signal Feeds → Local Data Access: reads feed data
- Portfolio Dashboard → Dashboard Metrics: loads metrics
- Dashboard Metrics → Local Data Access: reads signals, conversions
- Archive Review → Local Data Access: loads and saves
- Archive Review → Archived Projects: archives projects
- Daily Action → Signal Patterns: uses patterns
- Signal Patterns → Local Data Access: reads signal history
- AI Assistant → Project Context: builds context
- Project Context → Local Data Access: reads project history
- AI Assistant → Related History: retrieves related history
- Related History → Local Data Access: reads signals, decisions
- AI Assistant → AI Service: requests AI
- AI Service → Configured AI Provider: sends prompt
- Local Data Access → Local SQLite: reads and writes
- Tauri Runtime → Native Commands: registers commands
- Tauri Runtime → Local SQLite: enables SQL plugin
