Skip to content

[BUG]: Missing docker-compose.yml file referenced in documentation #276

Description

@khushigoel44-afk

🐛 Bug Description

The project's README.md explicitly instructs users to use Docker Compose for local development under the "Quick Start (Docker)" section and lists docker-compose.yml in the "Project Structure" tree. However, the docker-compose.yml file is currently missing from the repository root. This discrepancy breaks the documented onboarding flow for new contributors attempting to spin up the environment.

🔁 Steps to Reproduce

- Clone the Execra repository using git clone https://github.com/sahoo-tech/execra.git.
- Navigate to the root directory cd execra.
- Run the documented command: docker-compose up --build.
- See the terminal error indicating that the configuration file cannot be found.

✅ Expected Behavior

Running docker-compose up --build should successfully orchestrate and launch both the FastAPI backend and SvelteKit dashboard in a containerized environment, as documented in the README.

❌ Actual Behavior

The command fails immediately because there is no docker-compose.yml file present in the repository root to define the services.

📁 Affected Module (if known)

Infrastructure / Documentation

🔗 Related Issues / PRs

N/A

💡 Possible Solution (optional)

I will create and contribute the missing docker-compose.yml file at the root level to correctly orchestrate the backend (mapping port 8000 and .env variables) and the frontend SvelteKit dashboard (mapping port 5173). I am a GSSoC 2026 contributor and would like to be assigned this issue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions