Platforms Overview

DebuggAI works with any web application running on localhost. Get platform-specific setup instructions below.

Interactive Setup Guide

Platform Setup Wizard

Choose your platform for customized setup instructions

⚡

Next.js

React framework with server-side rendering

Default port: 3000

⚛️

React

JavaScript library for building user interfaces

Default port: 3000

🐍

Django

High-level Python web framework

Default port: 8000

🟢

Node.js

JavaScript runtime for server applications

Default port: 3000

🐍

Python/Flask

Lightweight Python web framework

Default port: 5000

🔧

Other Platform

Custom setup or different framework

Default port: 3000

Don't see your platform? Choose "Other Platform" for generic setup instructions.

Supported Platforms

Frontend Frameworks

• React: Create React App, Vite, custom webpack
• Next.js: App Router, Pages Router, API routes
• Vue.js: Vue CLI, Vite, Nuxt.js
• Angular: Angular CLI, standalone apps
• Svelte: SvelteKit, Vite setups

Backend Frameworks

• Node.js: Express, Koa, Fastify
• Python: Django, Flask, FastAPI
• Ruby: Rails, Sinatra
• PHP: Laravel, Symfony
• Java: Spring Boot

Any Localhost App

• Static site generators (Gatsby, Jekyll, Hugo)
• Custom applications on any port
• Microservices and API servers
• Local development environments

Platform Comparison

Platform	Default Port	Start Command	Common Issues
Next.js	3000	npm run dev	Port conflicts, API routes
React	3000	npm start	Router setup, proxy config
Django	8000	python manage.py runserver	ALLOWED_HOSTS, static files
Flask	5000	flask run	Virtual env, templates
Node.js	3000	npm start	CORS, static middleware

Universal Setup Steps

1. Start development server on any localhost port
2. Install DebuggAI VS Code extension
3. Update port in extension settings if not 3000
4. Press Cmd+Alt+C to create first test
5. Describe functionality in natural language

Quick Troubleshooting

Port Issues

• Default extension setting: localhost:3000
• Change in extension settings gear icon
• Any localhost port works (3000, 8000, 5000, 8080, etc.)

Server Not Accessible

• Confirm server running: check localhost:PORT in browser
• Check firewall blocking localhost connections
• Verify extension has correct port configured

Authentication Required

• Create test user accounts for development
• Consider disabling auth for local testing
• Use development authentication bypasses

---

Ready to get started? Choose your platform above for step-by-step setup, or jump to Quick Start for the fastest path to testing.