Local Development Guide

Local Development Guide

Quick Start

Start Both Services (Recommended)

./start_local.sh

This will:

• ✅ Start backend on http://localhost:8000
• ✅ Start frontend on http://localhost:3000
• ✅ Auto-reload on code changes
• ✅ Show startup status for both services

Press Ctrl+C to stop both services

---

Manual Startup (Alternative)

Backend Only

cd backend
source .venv/bin/activate
python3 -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Frontend Only

cd frontend
npm run dev

---

Access Points

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs (if in dev mode)
• Login Password: mgslg2025

---

Available Pages

• / - Home/Landing page
• /login - Login page
• /dashboard - Interactive Analytics Dashboard
• /ml-analytics - ML Predictions Dashboard
• /sace-dashboard - SACE Points Compliance Dashboard

---

Troubleshooting

Backend won’t start

cd backend
source .venv/bin/activate
pip install -r requirements.txt

Frontend won’t start

cd frontend
rm -rf node_modules package-lock.json
npm install

Database connection issues

Check .env file in backend directory:

DATABASE_URL=postgresql+asyncpg://user:password@localhost/dbname

Port already in use

# Kill process on port 8000 (backend)
lsof -ti:8000 | xargs kill -9

# Kill process on port 3000 (frontend)
lsof -ti:3000 | xargs kill -9

---

View Logs

# Backend logs
tail -f /tmp/mgslg-backend.log

# Frontend logs
tail -f /tmp/mgslg-frontend.log

---

Stop Services

• If using start_local.sh: Press Ctrl+C
• If running manually: Press Ctrl+C in each terminal window

---

Database Setup

The local database should already be configured. If you need to seed data:

cd backend
source .venv/bin/activate
python3 seed_database.py

---

Production vs Local

Local Environment:

• Backend: http://localhost:8000
• Frontend: http://localhost:3000
• Database: Local PostgreSQL

Production (Railway):

• Backend: https://backend-production-c351.up.railway.app
• Frontend: https://frontend-production-5e4e.up.railway.app
• Database: Railway PostgreSQL

---

Ready to develop! 🚀