# guilhermesob/development-environment-setup-with-docker architecture

> Architecture diagram of the GitHub repository guilhermesob/development-environment-setup-with-docker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guilhermesob/development-environment-setup-with-docker
- Repository: https://github.com/guilhermesob/development-environment-setup-with-docker

## Overview

##### Project type and purpose
- This is a Docker-based “Development Environment Setup” tool.
- Purpose: provide reproducible Debian/Arch containers preconfigured with NeoVim, Vim, Clang, Python, Ruby on Rails, etc., so developers can quickly spin up a consistent dev environment.

##### File structure
- Top-level folder “Docker” contains:
- Dockerfile            – main image recipe
- DockerfileNvimChad    – image variant with Neovim + Chad extensions
- Dockerfileem          – image variant with Emacs
- README.md at root describes overall project goal.

##### README for additional insights
- Confirms the supported hosts (Debian, Arch) and core installed tools.
- Version v0.0.1 suggests initial release; architecture is straightforward.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Host and Docker Engine
    Host["Host Machine"]:::host
    DockerEngine["Docker Engine/Daemon"]:::docker

    %% Documentation
    Documentation["README.md"]:::doc

    %% Build Context
    subgraph "Build Context"
        MainDF["Dockerfile"]:::build
        NvimDF["DockerfileNvimChad"]:::build
        EmacsDF["Dockerfileem"]:::build
    end

    %% Images
    subgraph "Built Images"
        ImageDefault["Image: DevEnv Base"]:::image
        ImageNvChad["Image: NvimChad Variant"]:::image
        ImageEmacs["Image: Emacs Variant"]:::image
    end

    %% Running Containers
    subgraph "Running Containers"
        ContainerDefault["Container: DevEnv Base"]:::container
        ContainerNvChad["Container: NvimChad"]:::container
        ContainerEmacs["Container: Emacs"]:::container
    end

    %% Volume
    Volume["Volume: Host Workspace"]:::volume

    %% Tools inside containers
    Tools["Tools: Neovim, Vim, Emacs, Clang, Python, Rails"]:::tools

    %% Relationships
    Host -->|"docker build"| DockerEngine
    DockerEngine -->|"reads Dockerfile"| MainDF
    DockerEngine -->|"reads Dockerfile"| NvimDF
    DockerEngine -->|"reads Dockerfile"| EmacsDF

    MainDF -->|"builds"| ImageDefault
    NvimDF -->|"builds"| ImageNvChad
    EmacsDF -->|"builds"| ImageEmacs

    ImageDefault -->|"docker run"| ContainerDefault
    ImageNvChad -->|"docker run"| ContainerNvChad
    ImageEmacs -->|"docker run"| ContainerEmacs

    Host -->|Mount| Volume
    Volume -->|mounted at /workspace| ContainerDefault
    Volume -->|mounted at /workspace| ContainerNvChad
    Volume -->|mounted at /workspace| ContainerEmacs

    ContainerDefault -->|contains| Tools
    ContainerNvChad -->|contains| Tools
    ContainerEmacs -->|contains| Tools

    Documentation --> Host

    %% Click events
    click MainDF "https://github.com/guilhermesob/development-environment-setup-with-docker/tree/main/Docker/Dockerfile"
    click NvimDF "https://github.com/guilhermesob/development-environment-setup-with-docker/tree/main/Docker/DockerfileNvimChad"
    click EmacsDF "https://github.com/guilhermesob/development-environment-setup-with-docker/tree/main/Docker/Dockerfileem"
    click Documentation "https://github.com/guilhermesob/development-environment-setup-with-docker/blob/main/README.md"

    %% Styles
    classDef host fill:#f0f8ff,stroke:#333,stroke-width:1px
    classDef docker fill:#bbdefb,stroke:#333,stroke-width:1px
    classDef doc fill:#fff9c4,stroke:#333,stroke-width:1px
    classDef build fill:#c8e6c9,stroke:#333,stroke-width:1px
    classDef image fill:#ffecb3,stroke:#333,stroke-width:1px
    classDef container fill:#b3e5fc,stroke:#333,stroke-width:1px
    classDef volume fill:#ffe0b2,stroke:#333,stroke-width:1px
    classDef tools fill:#d1c4e9,stroke:#333,stroke-width:1px
```
