Paragliding Weather Dashboard

Real-time paragliding weather conditions and forecasting application.

Features

• 🌤️ Real-time weather data from Open-Meteo
• 🪂 Paragliding-specific condition assessment
• 📊 Historical weather data tracking
• 🎯 Customizable safety thresholds
• ⚡ Fast API with caching
• 🔄 Automatic weather data updates

Tech Stack

• Backend: Go 1.24, Chi router, PostgreSQL
• Frontend: Next.js 14, React 18, TailwindCSS, Recharts
• Database: PostgreSQL 16
• Deployment: Docker/Podman, Kubernetes

Quick Start

Local Development (Fastest)

Run only PostgreSQL in a container, everything else natively:

# One command - setup AND start everything!
./dev.sh --start

# Or setup only, then start manually:
./dev.sh
make run-backend   # Terminal 1
make run-frontend  # Terminal 2

That's it! The --start flag sets up PostgreSQL, creates config files, runs migrations, AND starts both backend and frontend in the background.

Why local development?

• ✨ Faster hot-reload and rebuild times
• 🔧 Better debugging experience
• 📦 Smaller resource footprint
• 🚀 Quicker iteration cycles

See DEV_SETUP.md for detailed local development guide.

Full Container Development

Run everything in containers:

make dev

Access at:

• Frontend: http://localhost:3000
• Backend API: http://localhost:8080/api/v1

Available Make Commands

Local Development

• ./dev.sh - Recommended: Idempotent setup script
• make dev-local - Setup local development (runs dev.sh)
• make dev-db - Start PostgreSQL only
• make dev-db-down - Stop PostgreSQL
• make run-backend - Run backend locally
• make run-frontend - Run frontend locally

Container Development

• make dev - Start all services in containers
• make dev-down - Stop all containers
• make dev-logs - View backend logs
• make dev-logs-frontend - View frontend logs
• make dev-logs-postgres - View PostgreSQL logs

Database

• make migrate-up - Run migrations
• make migrate-down - Rollback last migration
• make migrate-create name=<name> - Create new migration

Testing

• make test - Run all tests
• make test-backend - Run backend tests only
• make test-frontend - Run frontend tests only

Build

• make build - Build backend and frontend
• make build-backend - Build backend only
• make build-frontend - Build frontend only

API Endpoints

• GET /api/v1/health - Health check
• GET /api/v1/weather/current - Current conditions
• GET /api/v1/weather/forecast - Weather forecast
• GET /api/v1/weather/historical?date=YYYY-MM-DD - Historical data
• POST /api/v1/assess - Assess conditions with custom thresholds

Configuration

Backend Environment Variables

See backend/.env.example for all configuration options:

• DATABASE_URL - PostgreSQL connection string
• PORT - Server port (default: 8080)
• LOCATION_LAT - Latitude for weather data
• LOCATION_LON - Longitude for weather data
• LOCATION_NAME - Location display name
• TIMEZONE - Timezone for weather data
• FETCH_INTERVAL - How often to fetch weather (default: 15m)
• CACHE_TTL - API response cache duration (default: 10m)

Frontend Environment Variables

See frontend/.env.local.example:

• NEXT_PUBLIC_API_URL - Backend API URL

Project Structure

.
├── backend/              # Go backend
│   ├── cmd/api/         # Application entry point
│   ├── internal/        # Internal packages
│   │   ├── cache/      # Caching layer
│   │   ├── client/     # External API clients
│   │   ├── config/     # Configuration
│   │   ├── model/      # Data models
│   │   ├── repository/ # Database layer
│   │   ├── server/     # HTTP server
│   │   └── service/    # Business logic
│   └── migrations/     # Database migrations
├── frontend/            # Next.js frontend
│   ├── app/            # Next.js app directory
│   ├── components/     # React components
│   ├── hooks/          # Custom React hooks
│   ├── lib/            # Utilities
│   └── store/          # State management
├── docker-compose.yml        # Full stack containers
├── docker-compose.dev.yml    # PostgreSQL only
├── dev.sh                    # Idempotent dev setup script
├── Makefile                  # Development commands
└── DEV_SETUP.md             # Detailed dev guide

Development Workflow

Initial Setup

# 1. Clone the repository
git clone <repo-url>
cd paragliding

# 2. Run setup script
./dev.sh

# 3. Start services (in separate terminals)
make run-backend
make run-frontend

Daily Development

# Start PostgreSQL (if not running)
make dev-db

# Start backend
make run-backend

# Start frontend
make run-frontend

Making Changes

• Backend: Changes auto-reload with Air (if installed) or restart manually
• Frontend: Changes auto-reload with Next.js Fast Refresh
• Database: Create migrations with make migrate-create name=<name>

Deployment

Docker/Podman

# Build and start all services
docker-compose up -d

# Or with podman
podman-compose up -d

Kubernetes

# Apply configurations
kubectl apply -f k8s.yaml

# Check status
kubectl get pods

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: make test
5. Submit a pull request

License

ISC

Support

For issues and questions, please open a GitHub issue.