Framework Detection

When you add a project, Pandev scans for common web frameworks and auto-detects:

Detection follows a precedence order — if a project has both Vite and Next.js, Next.js is detected (as it's higher priority).

Port Allocation

Pandev automatically assigns ports to avoid conflicts:

• Ports are allocated from a pool when a framework is detected
• You can override the port in the Project Setup Dialog or Project Settings
• Valid port range: 1–65535
• Port allocation is deferred until a dev command is detected (optimization for non-web projects)

Starting the Dev Server

From the Dashboard

Each project card with a configured dev command shows server controls:

• Play button — Start the dev server
• Stop button — Stop the running server
• Restart button — Stop and restart
• Kill + Start — Kill the port process (if stuck) and restart

Dev Server States

Integration with Browser Preview

When the dev server is running:

1. Open the Browser Preview panel (Cmd+B)
2. It automatically loads your dev server's URL (e.g., http://localhost:3000)
3. The preview updates in real-time as you make changes (HMR/hot reload from your framework)
4. Use the Screenshot button to capture the preview and share it with Claude

Configuring the Dev Command

To change the dev command or port after setup:

1. Open Settings (Cmd+,)
2. Switch to your project's scope
3. Navigate to General
4. Edit the Dev Command and Port fields

You can also edit these in the Project Setup Dialog when adding a project.