debug-runtime · git:20260331.d706a3e · 2026-03-31 · sha256 e615473d62c3fc8a

debug-runtime git:20260331.d706a3eC

Immutable. This exact content is served forever at /api/v1/blob/e615473d62c3fc8a.

# Debug Runtime

Diagnose runtime errors by connecting to the dev server via MCP.

## Steps

1. **Ensure dev server is running**
   ```bash
   veryfront dev
   ```
   MCP is available on port 9999.

2. **Check for errors** (via MCP)
   Use `vf_get_errors` to get current runtime errors.

3. **Get debug context** (via MCP)
   Use `vf_get_debug_context` for stack traces and request context.

4. **Read server logs** (via MCP resource)
   Read `veryfront://logs` for recent server log entries.

5. **Trace the issue**
   - Identify the failing route or component from error context
   - Read the source file
   - Check for common runtime issues: missing env vars, API failures, data fetch errors

6. **Fix and verify**
   Apply the fix. HMR will auto-reload.
   Use `vf_get_errors` to confirm the error is resolved.

## Error Recovery

- **Dev server not running**: Start with `veryfront dev`
- **MCP not responding**: Check port 9999, restart dev server
- **Error persists after fix**: Clear cache with `veryfront clean`, restart dev