Axion/TROUBLESHOOTING.md

Troubleshooting Blank Page Issue

If you're seeing a blank white page, try these steps:

1. Check the Correct Port

The dev server might be running on a different port. Check the terminal output - it should show:

➜  Local:   http://localhost:5174/

Make sure you're accessing the correct port (might be 5173, 5174, or another port).

2. Check Browser Console

Open your browser's developer console (F12 or Right-click → Inspect → Console tab) and look for any red error messages. Common issues:

• Module not found errors
• Import errors
• TypeScript errors

3. Clear Browser Cache

Try a hard refresh:

• Chrome/Edge: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
• Firefox: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)

4. Restart Dev Server

Stop the dev server (Ctrl+C) and restart it:

npm run dev

5. Reinstall Dependencies

If the above doesn't work:

rm -rf node_modules package-lock.json
npm install
npm run dev

6. Check for Build Errors

Run the build command to see if there are any TypeScript or build errors:

npm run build

Common Issues

"Cannot find module" errors

• Make sure all dependencies are installed: npm install
• Check that all import paths are correct

Tailwind CSS not working

• Make sure postcss.config.js and tailwind.config.js exist
• Check that index.css imports Tailwind directives

React Router issues

• Make sure you're accessing the root path /
• Check that all route components are properly exported