DevApp+ Documentation
Complete user guide and reference
Welcome to DevApp+!
Your comprehensive development workflow monitoring and project management tool.
First Time Setup
Launch DevApp+
After installation, DevApp+ will appear in your status bar (top-right corner of your screen). Look for the network icon.
Initial Configuration
Click the DevApp+ icon and select "Settings" to open the configuration window with multiple tabs.
Quick Start
DevApp+ works out of the box with default settings, monitoring ports 3000-9999 automatically.
Status Bar Icon
Green
No active processes
Orange
1-5 processes running
Red
6+ processes running
Main Menu Access
Click the status bar icon to access:
- • Process list - All currently running processes on monitored ports
- • Projects section - Your configured development projects
- • Settings - Configuration options
- • Quit DevApp+ - Close the application
What Gets Monitored
DevApp+ automatically scans for:
- • Configurable port ranges (default: 3000-9999)
- • Docker containers (if Docker integration is enabled)
- • Development servers (Node.js, Python, Ruby, etc.)
Reading Process Information
ProcessName - The name of the running application
PID - Process ID (useful for manual troubleshooting)
Port - Which port the process is using
Supported Package Managers
npm run dev
Standard Node.js projects
yarn dev
Projects using Yarn
pnpm dev
Fast, disk-efficient projects
bun dev
Ultra-fast JavaScript runtime
Adding Your First Project
Open Settings
Click DevApp+ icon → "Settings" → Navigate to the "Projects" tab
Add New Project
Click "Add Project" and fill in project name, path, and package manager
Optional Auto-Start
Check "Start dev server after adding" to automatically launch your project
Workflow Optimization
- • Organize projects by type
- • Use descriptive project names
- • Leverage auto-start for frequent projects
Performance Tips
- • Adjust scan interval (5s for active dev)
- • Filter noise with ignored processes
- • Disable Docker if not needed
Advanced Usage
- • Multiple environment management
- • Team collaboration settings
- • Standardized port ranges
Recommended Port Ranges
Frontend
3000-3999
Backend APIs
4000-4999
Databases
5000-5999
"No processes found" but servers are running
Solutions:
- • Check your port ranges in Settings → General
- • Verify the process isn't in the ignored processes list
- • Try increasing scan interval to 10 seconds
- • Restart DevApp+ if permissions were recently granted
Projects won't start
Solutions:
- • Verify project path points to your project root
- • Check if package manager is installed
- • Ensure there's a "dev" script in package.json
Docker containers not showing
Solutions:
- • Enable Docker Integration in Settings → General
- • Verify Docker is running with
docker ps - • Check Docker permissions for DevApp+
Getting Help
Enable Debug Mode:
Settings → Logging → Log Level → Debug, then restart DevApp+
Reset to Defaults:
Quit DevApp+, delete ~/Library/Preferences/novexa.DevApp-Plus.plist, restart
Can I monitor ports outside the 3000-9999 range?
Yes! Go to Settings → General and add custom port ranges. You can monitor any ports from 1-65535.
Will DevApp+ slow down my system?
DevApp+ is designed to be lightweight. It uses minimal CPU and memory. You can adjust the scan interval to reduce system calls if needed.
Can I use DevApp+ with non-JavaScript projects?
While the package managers are JavaScript-focused, the process monitoring works with any application running on your configured ports (Python, Ruby, Go, etc.).
Does DevApp+ work with monorepos?
Yes! Add each sub-project as a separate project in DevApp+, or add the monorepo root and use the appropriate package manager commands.
Can I backup my settings?
Your settings are stored in ~/Library/Preferences/novexa.DevApp-Plus.plist. You can backup this file to preserve your configuration.
Ready to supercharge your development workflow?
Download DevApp+ and start monitoring your processes like a ninja! 🥷
Download DevApp+ Now