🖥️ Software Engineer Environment

Your complete, opinionated development environment — ready in minutes.

From a blank machine to a fully configured workstation. One repo. Three languages. Three operating systems. Zero guesswork.

---

🌍 Select Your Language

Flag	Language	Guide
🇧🇷	Português	Acessar documentação →
🇺🇸	English	Access documentation →
🇪🇸	Español	Acceder a la documentación →

🧭 Quick Navigation

Jump straight to the guide for your OS and language:

	🇧🇷 Português	🇺🇸 English	🇪🇸 Español
🐧 Linux	Guia Linux	Linux Guide	Guía Linux
🪟 Windows WSL2	Guia Windows	Windows Guide	Guía Windows
🍎 macOS	Guia macOS	macOS Guide	Guía macOS
🔧 Tools	Ferramentas	Tools	Herramientas

⚡ Tech Stack

Everything you need for a modern software engineering workflow:

Category	Tool	Description
🐚 Shell	Fish Shell 4.2	Smart, user-friendly command-line shell
✨ Prompt	Starship	Minimal, blazing-fast, cross-shell prompt
🐳 Containers	Docker 29.x + Compose 5.x	Build, ship, and run applications anywhere
📝 Editor	VS Code	GitHub Dark Default theme, JetBrains Mono font, 70 extensions
⌨️ Terminal Editor	Neovim 0.11	Hyperextensible Vim-based text editor
📦 Version Manager	mise	Universal polyglot tool version manager
📂 File Listing	eza	Modern, maintained replacement for ls
🚀 Navigation	zoxide	Smarter cd — learns your habits
🔍 Fuzzy Finder	fzf	General-purpose command-line fuzzy finder
🤖 AI Assistants	Claude Code CLI + Gemini CLI	AI-powered coding assistants in your terminal
🔀 Version Control	Git	Distributed version control with custom aliases

📁 Repository Structure

environment/
├── 📄 README.md                    ← You are here
├── 📄 .gitignore
│
├── ⚙️ config/
│   ├── fish/config.fish            ← Shell configuration (aliases, integrations)
│   ├── vscode/settings.json        ← Editor settings (theme, fonts, behavior)
│   ├── vscode/keybindings.json     ← Custom keyboard shortcuts
│   ├── vscode/extensions.json      ← 70 recommended extensions
│   ├── mise/config.toml            ← Runtime version management
│   └── git/.gitconfig              ← Git aliases and preferences
│
└── 📚 docs/
    ├── pt-br/                      ← 🇧🇷 Documentação em Português
    │   ├── README.md
    │   ├── linux.md
    │   ├── windows.md
    │   ├── mac.md
    │   └── tools.md
    ├── en/                         ← 🇺🇸 English Documentation
    │   ├── README.md
    │   ├── linux.md
    │   ├── windows.md
    │   ├── mac.md
    │   └── tools.md
    └── es/                         ← 🇪🇸 Documentación en Español
        ├── README.md
        ├── linux.md
        ├── windows.md
        ├── mac.md
        └── tools.md

⚙️ Configuration Files

The config/ directory contains ready-to-use, opinionated configuration files:

File	What it does
fish/config.fish	Initializes Starship prompt, mise, zoxide, and fzf. Defines eza-based aliases (lz, lsz, lt) for beautiful file listings.
vscode/settings.json	Sets GitHub Dark Default theme, JetBrains Mono font, inlay hints for TypeScript, JavaScript, Python, and Go, GitHub Copilot configuration, and more.
vscode/keybindings.json	Custom keybindings — terminal toggle mapped to Ctrl+'.
vscode/extensions.json	70 curated extensions covering languages (Python, TypeScript, Go, PHP, Vue), Docker, Git, AI, testing, databases, themes, and productivity.
mise/config.toml	Manages tool versions — currently tracking eza (latest) and node (LTS).
git/.gitconfig	Sets Neovim as the default editor, enables pull rebase, and includes short aliases (st, co, br, cm, lg).

📜 License

This project is licensed under the MIT License — feel free to use, modify, and share.

---

Built with 💜 for developers who value their time.

Stop configuring. Start coding.