Troubleshooting Guide, - hokumcangus/taste-of-aloha GitHub Wiki

🛠️ Troubleshooting Guide

This guide covers common errors encountered during development and their verified solutions.

🐳 Docker Issues

Symptoms: 'docker' not recognized or Daemon not running

Fixes:

  1. Ensure Docker Desktop is running.
  2. Verify connection in PowerShell: docker info.
  3. If using WSL2, ensure your distro is enabled in Docker Settings > Resources > WSL Integration.

🎨 Frontend & Tailwind Issues

1. "Failed to load PostCSS config"

  • Add "type": "module" to apps/web/package.json.
  • Ensure apps/web/postcss.config.js uses export default syntax.

2. Tailwind v4 Plugin Error

  1. Install: npm install -D @tailwindcss/postcss inside apps/web.
  2. Update postcss.config.js to use '@tailwindcss/postcss': {}.

🔌 Backend & API Issues

1. CORS Policy Blocked

Ensure apps/backend/index.js includes app.use(cors()); before your routes.

2. Prisma Error P2021 (Table does not exist)

Run these commands to sync your Docker database:

docker exec taste-of-aloha-backend npx prisma db push --accept-data-loss
docker exec taste-of-aloha-backend node prisma/menu.seed.js


Task | Command
-- | --
Check Backend Health | Invoke-RestMethod http://localhost:3000/health
Check Menu Data | Invoke-RestMethod http://localhost:3000/api/menu
View Backend Logs | docker logs --tail 50 taste-of-aloha-backend