CAVE Data Viewer

A Flask API + React/TypeScript SPA for browsing CAVE (Connectome Annotation Versioning Engine) connectivity, decorations, and spatial features.

Extracted from ceesem/dash-connectivity-viewer after the legacy three-Dash-app layout was replaced with a unified workspace SPA. The package name cave_data_viewer reflects the new identity; the historical Dash dependency is gone.

Components

• cave_data_viewer/api/ — Flask backend. Connectivity, decorations, cell-id lookup, Neuroglancer link generation, server-side Plotly figure rendering, SpatialProvider abstraction for anatomy-specific spatial features.
• frontend/ — Vite + React + TypeScript SPA.

See CLAUDE.md for architecture notes.

Local development

# Backend (auto-discovers CDV_DATASTACK_CONFIG_DIR for datastack YAMLs).
# AirPlay squats on port 5000 — use 5001 locally.
CDV_DEV_AUTH_BYPASS=1 CDV_PORT=5001 uv run python run_api.py

# Frontend
cd frontend
npm install
npm run dev      # vite dev server
npm run build    # tsc -b && vite build

CDV_DEV_AUTH_BYPASS=1 skips middle-auth-client so a local dev environment doesn't need a CAVE token in cookies; production must run without it.

License

See LICENSE.txt.