Common Issues

Error: Cannot find module 'express'

Fix: Run npm install in the pipeline-dashboard directory

Error: EADDRINUSE: address already in use

Fix: Port 3000 is already occupied. Stop the other process or change PORT in server.js to 3001

Error: Empty sidebar

Fix: Check that your content directory has drafts/, published/, and inputs/ folders. Ensure you're running the server from inside pipeline-dashboard/

Error: Browser console shows CORS errors

Fix: Access http://localhost:3000, not opening index.html directly

Error: Annotations disappear on refresh

Fix: Check if annotations.json is being created in the pipeline-dashboard directory. Check file permissions.

Error: "Clear All" button doesn't work

Fix: Make sure you're clicking paragraphs (not headers or images) to annotate. Only markdown files support annotations.

Error: Images won't drop

Fix: Check that you're dragging image files (🖼️ icon in sidebar). Print mode only activates for published articles.

Error: Images don't stay after refreshing

Fix: Check that browser localStorage is enabled.

Error: Print output looks broken

Fix: Use "Save as PDF" in the print dialog, not printing to a physical printer. Ensure CSS is enabled in print preview.