🌺 E Komo Mai to the Taste of Aloha Wiki

Welcome to the Taste of Aloha project!
This wiki documents the structure of our monorepo so contributors can quickly understand how everything fits together.

📂 File Structure

taste-of-aloha/
  apps/
    web/                  # Vite.js frontend
      src/
        pages/            # React pages (Home, Menu, Checkout, etc.)
        routes/           # Client-side routing helpers
        components/       # UI components
        styles/           # Tailwind/Shadcn styles
      package.json
    backend/              # Node.js/Express or FastAPI backend
      src/
        index.js          # Entry point (server start)
        routes/           # API routes (menu, order, auth, etc.)
        controllers/      # Business logic
        models/           # Database models (Postgres, etc.)
        utils/            # Helpers (validation, middleware)
      package.json
    mobile/               # React - Wrap web page with React native wrapper (future)
  shared/
    configs/              # Shared configs (Docker, ESLint, Prettier)
    libs/                 # Shared utilities (schemas, constants)
  infra/
    docker-compose.yml    # Local dev orchestration
    k8s/                  # Kubernetes manifests (future scaling)
  package.json            # Root-level dependencies (lint, prettier, husky)
  README.md

📖 Documentation & Guides
Use these links to navigate our technical guides and project history:

🛠 Development Essentials
[Quick Reference Commands](/hokumcangus/taste-of-aloha/wiki/Quick-Reference-Commands) - Daily terminal commands for dev/test.

[API Reference](/hokumcangus/taste-of-aloha/wiki/API-Reference) - Detailed backend endpoint documentation.

[Testing Guide](/hokumcangus/taste-of-aloha/wiki/Testing-Guide) - How to run and write Vitest and Jest suites.

[Troubleshooting Guide](/hokumcangus/taste-of-aloha/wiki/Troubleshooting-Guide) - Solutions for common setup and Docker issues.

🏗 Architecture & Data
[Project Deep Dive](/hokumcangus/taste-of-aloha/wiki/Project-Deep-Dive) - Technical architecture and database evolution.

[Database & Menu Management](/hokumcangus/taste-of-aloha/wiki/Database-&-Menu-Management) - Instructions for populating the menu.

[Frontend & Logic Flow](/hokumcangus/taste-of-aloha/wiki/Frontend-&-Logic-Flow) - Tracking data from the UI to the Database.

🎓 Growth & History
[Learning Journey](/hokumcangus/taste-of-aloha/wiki/Learning-Journey) - Developer growth log and architectural decision records.

⚡ Quick Connectivity Check
Run this in PowerShell to ensure your local environment is active:

PowerShell
# Verify Backend Health (Expected: 200)
(Invoke-WebRequest -Uri "http://localhost:3000/health" -UseBasicParsing).StatusCode