Skip to content

Debugging

Debug frontend and backend code during local development using VS Code's integrated debugging capabilities.

Overview

All Framework App Templates provide pre-configured debugging setups through VS Code's launch.json and tasks.json files. These configurations enable you to:

  • Set breakpoints in your code
  • Step through execution
  • Inspect variables and call stacks
  • Debug frontend and backend simultaneously

Available Debug Configurations

Frontend Debugging

Frontend debugging configurations are available for multiple browsers (Chrome, Firefox). These configurations automatically start the development server via pre-launch tasks before opening the browser, allowing you to debug your frontend code directly in the browser's developer tools integrated with VS Code.

Backend Debugging

Backend debugging configurations are provided for each supported backend framework. These configurations:

  • Use the appropriate debugger for the language/runtime (e.g., debugpy for Python, Node.js debugger for JavaScript)
  • Set up the correct working directory and environment variables
  • May include template debugging support where applicable
  • Display output in VS Code's integrated terminal or debug console

Debugging Multiple Components

You can debug frontend and backend simultaneously:

  1. Start the backend debugger first
  2. Start the frontend debugger second
  3. Both will run concurrently, allowing you to debug full-stack interactions

The debug configurations are organized into groups (frontends and backends) for easy identification in the debug dropdown.

Pre-Launch Tasks

Frontend debugging relies on pre-launch tasks that start the development servers. These tasks run in the background and use problem matchers to detect when the server is ready before launching the browser.