Skip to content

README.md

Latest commit

聽

History

History
168 lines (116 loc) 路 4.84 KB

README.md

File metadata and controls

168 lines (116 loc) 路 4.84 KB
Raw

Software Engineer Environment

por nferdica

Idioma: Portugues (BR) | English | Espanol

Guia completo para configurar um ambiente de desenvolvimento moderno, produtivo e consistente em qualquer sistema operacional.

Sobre este Projeto

Este repositorio documenta meu ambiente de desenvolvimento pessoal como Engenheiro de Software. Aqui voce encontra configuracoes, dotfiles e guias passo a passo para replicar um setup completo e otimizado em Linux, Windows (WSL2) ou macOS.

O objetivo e simples: sair do zero ate um ambiente totalmente funcional com as melhores ferramentas disponiveis, sem perder tempo pesquisando configuracoes espalhadas pela internet.

Stack de Ferramentas

Ferramenta Categoria Descricao
Fish Shell Terminal & Shell Shell moderno com autocompletar inteligente e sintaxe amigavel
Starship Prompt Prompt minimalista, rapido e altamente customizavel
Docker Containers Plataforma de containerizacao para desenvolvimento e deploy
VS Code Editor/IDE Editor principal com 70+ extensoes para desenvolvimento full-stack
Neovim Editor Terminal Editor de terminal poderoso para edicoes rapidas e SSH
mise Gerenciador de Versoes Gerenciador universal de versoes (substitui nvm, pyenv, etc.)
eza Utilitario CLI Substituto moderno para o comando ls com icones e cores
zoxide Navegacao Substituto inteligente para cd que aprende seus habitos
fzf Busca Fuzzy finder interativo para arquivos, historico e mais
Claude Code AI no Terminal CLI da Anthropic para assistencia de codigo com IA
Gemini CLI AI no Terminal CLI do Google para assistencia de codigo com IA

Guias de Instalacao

Escolha o guia de acordo com seu sistema operacional:

Linux

Guia principal e mais completo. Fedora, Ubuntu/Debian e Arch Linux.

Windows (WSL2)

Setup completo usando WSL2. Docker Desktop + VS Code Remote.

macOS

Setup via Homebrew. Apple Silicon e Intel.

Ferramentas Essenciais

Guia detalhado de cada ferramenta. Instalacao, config e uso.

Pre-requisitos Gerais

Antes de comecar qualquer guia, certifique-se de ter:

  • Acesso administrativo ao sistema (sudo/admin)
  • Conexao com a internet estavel
  • Git instalado (os guias cobrem a configuracao, mas o Git deve estar disponivel)
  • Conta no GitHub (recomendado para sincronizar configuracoes)
  • Chave API para as ferramentas de IA (Anthropic para Claude Code, Google para Gemini CLI)

Dica: Se voce esta comecando do zero em um sistema Linux, recomendo fortemente seguir o guia Linux na ordem apresentada. Para Windows ou macOS, siga o guia respectivo do inicio ao fim.

Estrutura do Repositorio

environment/
  config/
    fish/
      config.fish          # Configuracao do Fish Shell
    git/
      .gitconfig           # Configuracao global do Git
    mise/
      config.toml          # Ferramentas gerenciadas pelo mise
    vscode/
      settings.json        # Configuracoes do VS Code
      keybindings.json     # Atalhos personalizados
      extensions.json      # Lista de extensoes recomendadas
  docs/
    pt-br/                 # Documentacao em Portugues
    en/                    # Documentation in English
    es/                    # Documentacion en Espanol

Versoes das Ferramentas

As versoes utilizadas e testadas neste ambiente:

Ferramenta Versao
Fish Shell 4.2.0
Starship 1.24.2
Docker Engine 29.1.5
Docker Compose 5.0.2
Neovim 0.11.5
eza 0.23.4
zoxide 0.9.8
fzf 0.67.0

Aviso: As versoes podem variar dependendo do seu sistema operacional e repositorios. Os guias utilizam os comandos para instalar as versoes mais recentes disponiveis.

Inicio Rapido

Se voce ja sabe o que esta fazendo e quer apenas copiar as configuracoes:

# Clone o repositorio
git clone https://github.com/nferdica/environment.git
cd environment

# Copie as configuracoes (ajuste os caminhos conforme necessario)
cp config/fish/config.fish ~/.config/fish/config.fish
cp config/git/.gitconfig ~/.gitconfig
cp config/mise/config.toml ~/.config/mise/config.toml

Para o VS Code, copie os arquivos da pasta config/vscode/ para o diretorio de configuracao do VS Code:

  • Linux: ~/.config/Code/User/
  • macOS: ~/Library/Application Support/Code/User/
  • Windows: %APPDATA%\Code\User\

Feito com mass por nferdica