From 269962455e43411195937b4b8508c1808e575c5c Mon Sep 17 00:00:00 2001 From: Alex Date: Mon, 19 May 2025 14:28:04 +0200 Subject: [PATCH] docs: add usage guide for debugging in VSCode --- .vscode/debug.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 .vscode/debug.md diff --git a/.vscode/debug.md b/.vscode/debug.md new file mode 100644 index 0000000..13bc178 --- /dev/null +++ b/.vscode/debug.md @@ -0,0 +1,13 @@ +# Debugging in VSCode/Cursor (no Turbopack) + +This project includes a VSCode debug configuration using the `pwa-node` debugger. + +- Turbopack is disabled during debugging to ensure stable breakpoint support across platforms (especially on Windows). +- The debugger starts Next.js in development mode using `pnpm exec next dev`. + +## How to Use + +1. Press **F5** or start debugging via the VSCode/Cursor menu (Run → Start Debugging) +2. Set breakpoints in your code +3. For pages/components: save the file to trigger Fast Refresh + For API routes: manually re-trigger the route (e.g. in the browser), since they don’t re-run automatically on save