How boris-boomer/shipsignal works
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: db.ts Local Data Access · router.tsx App Router · AiPage.tsx AI Assistant · ArchiveReview.tsx Archive Review
Components 21
Project Evidence & Review
- App Router
src/app/router.tsx - Project Setup
src/features/onboarding/OnboardingPage.tsx - Project Records
src/features/projects/ProjectDetailPage.tsx - Archive Review
src/features/projects/ArchiveReview.tsx - Archived Projects
src/features/harbor/HarborPage.tsx - Signal Feeds
src/lib/feeds/index.ts - RSS Sources
src/features/settings/RssSourceManager.tsx
Insights & Guidance
- Signal Patterns
src/lib/signalPatterns.ts - Daily Action
src/features/today/TodayPage.tsx - Portfolio Dashboard
src/features/projects/DashboardPage.tsx - Dashboard Metrics
src/features/projects/dashboard/useDashboardData.ts
AI Assistance
- AI Assistant
src/features/ai/AiPage.tsx - Project Context
src/lib/aiContext.ts - Related History
src/lib/rag/retriever.ts - AI Service
src/lib/ai.ts
Desktop & Storage
- Local Data Access
src/lib/db.ts - Local SQLite
src/lib/db.ts - Tauri Runtime
src-tauri/src/lib.rs - Native Commands
src-tauri/src/commands/mod.rs
Other components
- Developer
- Configured AI Provider
Connections 24
- 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