docs: add comprehensive feature specifications for Tauri migration#2
Open
docs: add comprehensive feature specifications for Tauri migration#2
Conversation
Feature specs define ideal behavior without implementation details, serving as the blueprint for rebuilding RadFlow as a native Tauri app. Documented features: - Variables Editor (design tokens, colors, shadows, radius) - Typography Editor (fonts, type scale, fluid typography) - Component System (discovery, preview, editing) - Theme System (multi-theme, switching, configuration) - Assets Manager (icons, logos, images) - Tools & Modes (component ID, text edit, help) - Search & Navigation (global search, keyboard shortcuts) - Canvas Editor (future system-level view) - AI Integration (prompts, generation, assistance) - Tauri Architecture (Rust backend specification)
- Visual: minimal pills showing element type - Clipboard: full path + line number for LLM precision - Selection: click, shift+click (multi), shift+cmd+click (all of type) - Line numbers: live/accurate via Rust file watcher - Format optimized for minimal tokens, maximum precision
… game - Rename Component System → Component Browser (editor feature) - Add Component Library section to Theme System (theme owns components) - Theme provides: components, tokens, typography, visual identity - Editor provides: discovery, preview, editing UI, persistence - Add "editor is console, theme is game" architecture principle
Added: - Animation tokens (duration scale, timing function) - Effects tokens (backdrop blur, focus ring) - Clear scope definition (what Variables owns vs doesn't) - Updated persistence targets - New ideal behaviors for animation/effect preview
Inspect Mode: - Spacing visualization (padding/margin overlays) - Measurement tool (Alt+hover like Figma) - Layout visualization (flex/grid structure) - Token reference (show which tokens are applied) Responsive Preview: - Device frame presets (phone, tablet, desktop) - Custom size input - Breakpoint indicator
- Styleguide view of all HTML text elements (h1-h6, p, a, li, etc.) - Properties Panel with quick-edit controls (not arbitrary values) - Tag conversion (h1 → p, etc.) keeps code clean - Font Manager for add/link/upload fonts - Direct text editing writes to source files - No arbitrary inline styles — prompt for custom classes
- Text editing now direct in Typography Editor (writes to files) - Removed Text Edit Mode section from Tools - Removed Text Edit Enhancements from Ideal Behaviors - Removed Spacing/Color/Responsive from New Modes (already covered)
- Icons: component with `name` prop, size options - Logos: component with `variant` prop - Click to copy name/variant for prompting - Right-click context menu for size options - Size configuration editable in panel - Open in Finder for file organization (offload to native) - All assets theme-owned
- Updated Search & Navigation shortcuts to reference Inspect Mode - Updated Tools & Modes help contexts to remove Text Edit Mode - Aligned mode documentation with Typography Editor merge
- Canvas is default view on project open - Component definitions with sort/filter by properties - Design system violation detection with "Needs Review" section - Multi-select for AI targeting (bulk Component ID copy) - Properties Panel for contextual editing - Page Editor entered via "Edit" button on page thumbnails - Obsidian integration for docs (future)
- Cmd+F for content search, Cmd+E for contextual prompt builder - Git as save: Cmd+S commits, Cmd+W prompts commit/discard - Canvas navigation: Cmd+1/2/3/4 for sections, E to enter edit mode - Figma-style shortcuts (V, T, I, H, Z for tools) - Single canvas + tabbed page editors - Vim mode optional in preferences - Function keys mappable - Snapshot system for discard (needs separate spec)
- MVP scope: prompt builder + context provider (not embedded AI) - Cmd+E prompt builder with context injection - Prompt library organization - SREF codes as per-theme style references - Claude Code integration via Skills (not MCP) - Embedded AI marked as post-MVP
Each spec now includes: - Complexity assessment (Low/Medium/High/Very High) - Research required (specific technical areas) - Search terms for investigation - Rust backend integration (modules, crates, commands) - Technical challenges and risks - Reference implementations to study - Open questions for future decisions Complexity breakdown: - Low: Assets Manager, AI Integration (MVP) - Medium: Variables Editor, Typography Editor, Theme System - High: Component Browser, Tools & Modes - Very High: Canvas Editor Key research areas identified: - Canvas: react-konva vs fabric.js vs custom - Parsing: lightningcss (CSS), SWC (TSX) - Search: tantivy fuzzy search - Git: git2-rs commit workflow - Component ID: React fiber + source maps Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Feature specs define ideal behavior without implementation details,
serving as the blueprint for rebuilding RadFlow as a native Tauri app.
Documented features: