Skip to main content

Desktop Features

Complete overview of Desktop app features.

Project Management​

Add Projects​

Use the file system picker to select project directories:

  • Click "Add Project" button
  • Navigate to your project directory
  • Project is automatically added with directory name
  • Optionally customize the name

View Projects​

See all tracked projects in the sidebar:

  • Project name
  • Project path
  • Quick access to project details

Project Details​

View comprehensive project information:

  • Project name and path
  • Detected framework
  • Test files and frameworks
  • Port information
  • Last scanned timestamp

Test Information​

View Tests​

See all detected test files:

  • Test file paths
  • Test frameworks (Jest, Vitest, Mocha)
  • Test status (if available)

Scan Projects​

Trigger test scans directly from the UI:

  • Click "Scan" button on a project
  • View scan results in real-time
  • See updated test counts

Port Information​

View detected ports for each project:

  • Port numbers
  • Script names (if applicable)
  • Config sources
  • Last detected timestamp

Real-time Updates​

The Desktop app updates in real-time:

  • New projects appear automatically
  • Scan results update immediately
  • Port information refreshes

API Integration​

The Desktop app:

  • Automatically starts the API server
  • Communicates via REST API
  • Shows API status in status bar
  • Handles API errors gracefully

UI Features​

Dark/Light Mode​

Switch between themes (if supported):

  • System preference detection
  • Manual theme selection

Responsive Layout​

The UI adapts to:

  • Window resizing
  • Different screen sizes
  • Multiple monitor setups

Status Bar​

Bottom status bar shows:

  • API server status
  • API port number
  • Connection status
  • Error messages (if any)

Keyboard Shortcuts​

Common shortcuts:

  • Cmd/Ctrl + R - Refresh projects
  • Cmd/Ctrl + , - Settings (if available)
  • Esc - Close dialogs

Next Steps​