Back to Spacedrive

Epic: Interface V2 Architecture

.tasks/interface/UI-000-interface-v2.md

0.4.31.0 KB
Original Source

Description

Complete rewrite of the Spacedrive interface using React 19, TypeScript, and a clean component architecture. The interface is platform-agnostic and works across Tauri (desktop), web, and mobile.

Key Principles

  • Platform agnostic architecture
  • Type-safe client with auto-generated types from Rust
  • Semantic color system with Tailwind
  • Clean separation: @sd/interface (features) + @sd/ui (primitives) + @sd/ts-client (state)
  • Accessible, performant, production-ready

Implementation Notes

  • Built with React 19, TanStack Query, Framer Motion
  • Uses native macOS traffic lights (no CSS fakes)
  • V2 design is more rounded than V1 (rounded-lg vs rounded-md)
  • All colors use semantic Tailwind classes, never var() directly

Acceptance Criteria

  • Type-safe client with auto-generated types
  • Native macOS traffic lights working
  • V2 color system as CSS variables
  • TanStack Query integration
  • Complete Explorer with file operations
  • Settings pages functional
  • Multi-window support
  • Mobile app integration