sparrow/frontend/README.md
pyr0ball 3c30cbe40d feat: add Sparrow frontend scaffold (Vue 3 + Vite + TypeScript)
Stack: Vue 3 + Pinia + WaveSurfer.js + TypeScript, proxied to FastAPI on :8513

Components
- ChainSidebar: chain list, create/delete, active chain highlight
- ChainTree: spine row (committed nodes) + branch row, upload drop zone, export buttons
- NodeCard: status dot + label, duration, commit/discard actions, generating spinner
- BranchPanel: WaveSurfer waveform + branch form (prompt, duration, cfg, prompt window)
- WavePlayer: WaveSurfer.js waveform with play/pause and time display

State & SSE
- Pinia chain store: REST for tree, SSE patch for live node status updates
- useNodeSSE composable: EventSource per active chain, auto-reconnects on error
- applyStatusEvent(): merges node-status SSE events into store without full refetch

UX
- Dark theme by default, light theme via prefers-color-scheme
- CSS custom properties throughout for easy theming
- Responsive: sidebar + main split, compact at <640px

manage.sh updated: start/stop both API (:8513) and frontend (:8514) together
2026-04-17 15:35:03 -07:00

5 lines
442 B
Markdown

# Vue 3 + TypeScript + Vite
This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
Learn more about the recommended Project Setup and IDE Support in the [Vue Docs TypeScript Guide](https://vuejs.org/guide/typescript/overview.html#project-setup).