Skip to content

[Good First Issue] Add Docker Compose for full-stack local development #13

@Oshgig

Description

@Oshgig

Overview

New contributors currently have to manually piece together how to run the full stack (FastAPI backend + React frontend + GEE credentials). A docker-compose.yml would let anyone spin up the entire application with one command.

Scope

  • Create Dockerfile for the Python backend (multi-stage: builder + runtime)
  • Create Dockerfile for the React frontend (nginx serve static build)
  • Create docker-compose.yml with services:
    • api — FastAPI backend
    • frontend — React app served via nginx
    • Optional: mlflow — experiment tracking UI
  • Document .env variables needed for Docker in GETTING_STARTED.md
  • Ensure GEE service account key can be mounted as a volume

Acceptance Criteria

  • docker-compose up starts the full stack on http://localhost:8000 (API) and http://localhost:5173 (frontend)
  • Backend can reach GEE when credentials are provided
  • Frontend can reach backend API
  • No local Python/Node installation required

Resources

  • setup.py, requirements.txt — Python dependencies
  • frontend/package.json — Node dependencies
  • GETTING_STARTED.md — existing onboarding guide

Difficulty: Beginner-friendly to Intermediate
Labels: good first issue, devops, documentation

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions