Skip to content

RELEASE_TRACKER.md

Latest commit

 

History

History
305 lines (248 loc) · 8.75 KB

RELEASE_TRACKER.md

File metadata and controls

305 lines (248 loc) · 8.75 KB

Dora v1.0 Release Tracker

Current Version: 0.0.92 Target Release: 1.0.0 Branch: feat/delete-confirmation-and-ui-alignment

Status Overview

Phase Status Progress
Core Features Complete 100%
UX Polish In Progress 85%
Error Handling Complete 100%
Empty States Complete 100%
Form Validation Not Started 0%
Testing Partial 20%

Session Progress (2025-02-02)

Completed This Session

Error Handling & UX

  • Created ErrorBoundary class component (shared/ui/error-boundary.tsx)
  • Created ErrorFallback with smart error mapping (shared/ui/error-fallback.tsx)
  • Created mapConnectionError utility (shared/utils/error-messages.ts)
  • Wrapped DatabaseStudio, SqlConsole, DockerManager with ErrorBoundary
  • Added friendly error messages to all connection operations
  • Added EmptyState for "no connections" in main view

Non-Functional UI Fixes

  • Removed dead handleToolbarAction code from database-sidebar.tsx
  • Disabled SSH Tunnel UI with "Soon" badge (was showing UI but hardcoded to null)
  • Updated Dora AI view to use NotImplemented component with proper description
  • Schema Visualizer correctly shows "(Coming Soon)" in tooltip

Native Dialog Replacement

  • Replaced alert() with toast notifications in seed-view.tsx
  • Replaced confirm() with AlertDialog in database-sidebar.tsx (bulk drop/truncate)
  • Fixed stray "3" text in studio-toolbar.tsx

Cleanup

  • Removed AUDIT_REPORT.html, AUDIT_TASKS.md, recap.md
  • Removed unused imports (Wand2, ToolbarAction, SshTunnelConfig)
  • Removed debug console.log statements from:
    • disabled-feature.tsx
    • database-studio.tsx (loadTableData, row actions)
    • sql-console/api.ts (query execution logs)

New Files Created

apps/desktop/src/shared/ui/error-boundary.tsx
apps/desktop/src/shared/ui/error-fallback.tsx
apps/desktop/src/shared/utils/error-messages.ts

Files Modified

apps/desktop/src/pages/Index.tsx
  - Added ErrorBoundary wrapping
  - Added EmptyState for no connections
  - Updated to use NotImplemented for Dora AI
  - Added mapConnectionError for all connection errors

apps/desktop/src/features/sidebar/database-sidebar.tsx
  - Removed dead handleToolbarAction function
  - Removed unused ToolbarAction import
  - Replaced confirm() with AlertDialog for bulk drop/truncate

apps/desktop/src/features/docker-manager/components/seed-view.tsx
  - Replaced alert() with toast notifications

apps/desktop/src/features/database-studio/components/studio-toolbar.tsx
  - Fixed stray "3" text

apps/desktop/src/features/database-studio/database-studio.tsx
  - Removed debug console.log statements

apps/desktop/src/features/sql-console/api.ts
  - Removed debug console.log statements

apps/desktop/src/shared/ui/disabled-feature.tsx
  - Removed debug console.log statement

apps/desktop/src/features/sidebar/components/bottom-toolbar.tsx
  - Made onAction prop optional

apps/desktop/src/features/connections/components/connection-dialog/connection-form.tsx
  - Disabled SSH tunnel checkbox with "Soon" badge and tooltip
  - Removed unused SshTunnelConfigForm import

What's Implemented

Database Studio (Core Feature)

  • Table browser with pagination
  • CRUD operations (create, read, update, delete rows)
  • Column management (add/drop columns)
  • Row selection (single + bulk)
  • Delete confirmation dialogs (respects settings)
  • Bulk edit dialog
  • Set NULL dialog
  • Drop table dialog
  • CSV export (selected rows)
  • CSV export (all rows)
  • Data seeder dialog
  • Sort and filter support
  • Primary key detection
  • Soft delete backend support (LibSQL)

SQL Console

  • Monaco editor with syntax highlighting
  • Query execution
  • Results grid with column definitions
  • Query history panel + zustand store
  • Keyboard shortcuts (Cmd+Enter to run)
  • Snippets sidebar
  • Cheatsheet panel
  • Toggle panels (left sidebar, history, filter)

Connections

  • Add/edit/delete connections
  • Connection testing
  • Multiple database types (LibSQL, SQLite, PostgreSQL, MySQL)
  • Connection list in sidebar
  • Friendly error messages for connection failures
  • SSH tunnel UI (fields exist, not wired)

Docker Manager

  • Container list view
  • Container logs
  • Start/stop containers
  • Export docker-compose

Error Handling

  • ErrorBoundary wraps all major features
  • ErrorFallback with smart error categorization
  • Connection errors → friendly messages
  • Network errors → friendly messages
  • Permission errors → friendly messages
  • Timeout errors → friendly messages
  • Technical details expandable for debugging

Empty States

  • No connections → shows onboarding CTA
  • No database connected → shows add connection button
  • No tables → shows explanation
  • Search returns nothing → shows feedback

UI Components (Shared)

  • AlertDialog (shadcn)
  • All core shadcn components
  • EmptyState component
  • ErrorState component
  • ErrorBoundary component
  • ErrorFallback component
  • Skeleton component
  • DisabledFeature component
  • NotImplemented component

Backend (Rust/Tauri)

  • LibSQL connection handling
  • SQLite connection handling
  • Query execution with timing
  • Table schema introspection
  • Row mutations (insert, update, delete)
  • Soft delete support
  • Truncate table support
  • Script/snippet storage
  • Settings persistence
  • Command shortcuts system

What's Missing for v1.0

Phase 1: Form Validation (HIGH)

Prevent invalid data submission.

  • Install zod + @hookform/resolvers
  • Add record dialog validation
  • Edit cell validation
  • Connection form validation
  • Type-specific validators (int, date, JSON, etc.)

Phase 2: Polish (MEDIUM)

  • Consistent keyboard navigation
  • ARIA labels for accessibility
  • SSH tunnel actually working

Phase 3: Testing (MEDIUM)

  • Fix existing test failures
  • Add integration tests for critical paths
  • Connection add/edit/delete tests
  • Query execution tests

Uncommitted Changes

Backend (Rust)

  • commands.rs - new commands
  • schema.rs - schema updates
  • maintenance.rs - soft delete + truncate
  • mutation.rs - mutation updates

Frontend

  • Index.tsx - ErrorBoundary wrapping, empty states, error mapping
  • database-studio.tsx - delete confirmation, CSV export
  • sql-console.tsx - query history integration
  • console-toolbar.tsx - history toggle
  • data-grid.tsx - grid improvements
  • studio-toolbar.tsx - toolbar updates

New Files (Untracked)

  • error-boundary.tsx - React error boundary
  • error-fallback.tsx - Friendly error UI
  • error-messages.ts - Error mapping utility
  • query-history-panel.tsx - history UI
  • query-history-store.tsx - zustand store
  • empty-state.tsx - generic empty state
  • error-state.tsx - basic error display
  • skeleton.tsx - loading skeletons
  • disabled-feature.tsx - feature flags
  • not-implemented.tsx - placeholder

Release Checklist

Before Release

  • Error boundaries implemented
  • Error messages are user-friendly
  • Empty states provide guidance
  • Form validation prevents bad data
  • Tests passing
  • No TypeScript errors
  • Manual QA pass
  • Update CHANGELOG.md
  • Update version to 1.0.0

Release Process

  1. Commit all pending changes
  2. Merge feature branch to master
  3. Tag release v1.0.0
  4. Build binaries (macOS, Windows, Linux)
  5. Create GitHub release
  6. Update documentation

Commands

# Development
bun run desktop:dev

# Tests
bun run test

# Build
bun run build

# Desktop build
bun run desktop:build

File Structure Reference

apps/desktop/
├── src/
│   ├── features/
│   │   ├── database-studio/    # Main data grid feature
│   │   ├── sql-console/        # Query editor
│   │   ├── connections/        # Connection management
│   │   ├── docker-manager/     # Docker integration
│   │   └── settings/           # App settings
│   ├── shared/
│   │   ├── ui/                 # Reusable components
│   │   │   ├── error-boundary.tsx
│   │   │   ├── error-fallback.tsx
│   │   │   ├── empty-state.tsx
│   │   │   └── ...
│   │   └── utils/
│   │       ├── error-messages.ts
│   │       └── ...
│   └── pages/
│       └── Index.tsx           # Main app shell
├── src-tauri/
│   └── src/
│       ├── database/           # DB operations
│       └── commands/           # Tauri commands

Last updated: 2025-02-02