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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions