58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
# 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:
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
## 5. Reinstall Dependencies
|
|
If the above doesn't work:
|
|
```bash
|
|
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:
|
|
```bash
|
|
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
|
|
|
|
|