SynergyPlan — Architecture

Overview

SynergyPlan is a visual project dashboard built with SvelteKit. It reads structured markdown files from a projects/ directory and renders them as an interactive dashboard with progress tracking, milestone management, and document viewing.

Tech Stack

• Framework: SvelteKit 5 (Svelte runes) + adapter-node
• Styling: Tailwind CSS with dark theme
• Data: Markdown files + YAML — no database
• Deployment: VPS (46.225.215.146), PM2, Caddy reverse proxy
• URL: https://plan.jonathanvandelustgraaf.nl

Key Directories

• projects/ — one folder per project (data layer)
• src/lib/parser/ — inventory, project, and markdown parsers
• src/lib/server/ — project scanner, loader, ideas system
• src/routes/ — SvelteKit pages and API endpoints
• skills/ — Claude Code integration skill

Data Flow

1. User visits a page (e.g., /bibleweb)
2. SvelteKit server load reads projects/bibleweb/project.yaml and feature-inventory.md
3. Parsers extract structured data (areas, features, milestones, coverage)
4. Page component renders the dashboard with progress bars and feature boards
5. API endpoints provide the same data as JSON for Claude Code integration