ealen/codespaces repository overview

⁠🧑‍💻 Codespace - Development Environment

⁠📦 Environment

• Base: Ubuntu 24.04⁠

⁠🖥 Terminal

• ZSH⁠ & Oh-My-ZSH⁠ Zsh is a shell designed for interactive use, although it is also a powerful scripting language.
• Starship⁠ The minimal, blazing-fast, and infinitely customizable prompt for any shell!
• LSD⁠ Colorizes the ls output with color and icons.
• TheFuck⁠ The Fuck is a magnificent app, that corrects errors in previous console commands.
• JQ⁠ jq is a lightweight and flexible command-line JSON processor.
• fd-find⁠ A simple, fast and user-friendly alternative to 'find'

⁠🔧 Tools

• Vim⁠ Vim is a highly configurable text editor built to make creating and changing any kind of text very efficient.
• NeoVim⁠ Vim-fork focused on extensibility and usability
  • ecosse3/nvim⁠ A non-minimal Neovim config built to work most efficiently with Frontend Development
• LazyDocker⁠ & LazyGit⁠ The lazier way to manage everything in docker or git
• But also git, gpg, curl, wget, etc.

⁠🧑‍💻 Languages & Runtimes

• Go⁠ A simple, fast, and reliable language designed for scalable and efficient software development.
• Rust⁠ A language empowering everyone to build reliable and efficient software.
• NVM⁠ with Node LTS⁠ installed by default. NVM is a version manager for NodeJS.
• ZX⁠ Bash is great, but when it comes to writing scripts, people usually choose a more convenient programming language.
• Python3⁠ Python is a programming language that lets you work quickly and integrate systems more effectively.
  • UV⁠ An extremely fast Python package and project manager, written in Rust.

⁠🐳 Docker-in-Docker

• Full Docker CLI and Compose support inside container
• docker.sock ready for volume mount

⁠💡 Remote Containers (VS Code)

This image is compatible with VS Code Remote Containers⁠, enabling a full development experience using a containerized environment.

⁠Example .devcontainer/devcontainer.json:

{
  "name": "codespaces",
  "image": "ealen/codespaces",
  "extensions": [
    "golang.go",
    "dbaeumer.vscode-eslint",
    "oouo-diogo-perdigao.docthis",
    "bungcip.better-toml",
    "redhat.vscode-yaml",
    "yzhang.markdown-all-in-one",
    "editorconfig.editorconfig",
    "gruntfuggly.todo-tree",
    "eamodio.gitlens",
    "naumovs.color-highlight",
    "vscode-icons-team.vscode-icons",
    "ms-azuretools.vscode-docker"
  ],
  "settings": {
    "workbench.iconTheme": "vscode-icons",
    "editor.fontFamily": "Consolas, 'Courier New', monospace, hack, 'Hack Nerd Font Mono'",
    "terminal.integrated.fontFamily": "Consolas, 'Hack Nerd Font Mono'",
    "terminal.integrated.fontSize": 14,
    "files.autoSave": "onFocusChange",
    "editor.tabSize": 2,
    "eslint.format.enable": true,
  },
  "mounts": [
    "source=/home/YOUR_USER/.ssh,target=/home/ubuntu/.ssh,type=bind,readonly",
    "source=/home/YOUR_USER/.gnupg,target=/home/ubuntu/.gnupg,type=bind,readonly",
    "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind"
  ]
}

⁠🐋 Raw Docker Usage

You can run the image without VS Code using standard Docker commands.

Example: Run with persistent volumes and access to Docker

docker run -it --rm \
  -v ~/.ssh:/home/ubuntu/.ssh:ro \
  -v ~/.gnupg:/home/ubuntu/.gnupg:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd):/workspace \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -w /workspace \
  ealen/codespaces

💡 Note: The Codespaces Docker image is also available on GitHub Container Registry.

If your company restricts access to docker.io, you can use the GitHub-hosted image instead by replacing ealen/codespaces with ghcr.io/ealenn/codespaces.

alias codespaces='docker run -it --rm \
  -v "$HOME/.ssh:/home/ubuntu/.ssh:ro" \
  -v "$HOME/.gnupg:/home/ubuntu/.gnupg:ro" \
  -v "/var/run/docker.sock:/var/run/docker.sock" \
  -v "$PWD:/workspace" \
  -w /workspace \
  ghcr.io/ealenn/codespaces'

⁠💻 GitHub Codespaces Support

This image is fully compatible with GitHub Codespaces⁠!

To use:

1. Create a .devcontainer/devcontainer.json in your repo (as shown above).
2. Push to GitHub.
3. Open the repo in Codespaces.

That's it! You'll get a fully functional container with Docker, ZSH, Starship, Go, Rust, Node, and Python already configured.

⁠📁 Example Repo

You can find a working example inside the example/⁠ folder.