How lucasbretana/dotfiles works
Project type and purpose
• This is a “dotfiles” repository whose goal is to manage and install a user’s shell/SX window-manager/editing environment. It groups all configuration files (bashrc, vimrc, tmux.conf, i3 configs, etc.) and utility scripts under one version-controlled tree and uses an install.sh + env file to symlink them into the user’s home directory.
File structure
• Top-level items
• .gitignore, README.md
• install.sh – orchestrates the linking process
• env – environment variables that drive installation paths
• home/ – contains everything that will be linked into ~
• Under home/
• Single files: vimrc, bashrc, Xresources, gdbinit, etc.
• Subdirectories:
– bin/ – custom utility scripts (bandwidth.sh, battery.pl, etc.)
– txt/ – static text assets (e.g., quotes)
– config dirs for window manager and status bar: i3config, i3blocksconfig, i3statusconfig
• Linking pattern
• Regular files in home/ → symlink to ~/.* (e.g. home/vimrc → ~/.vimrc)
• Directories in home/ → their contents symlinked into corresponding target dir (home/bin/* → ~/.local/bin/)
README for additional insights
• Describes two install-rules (file vs. directory linking)
• Mentions modular bash setup (.benv, .baliases, .bfunctions)
• Notes future plans for WM transition (compton)
• Emphasizes no external Vim plugins, pure shell scripting
Key reminders
• Flow: clone → install → runtime sourcing → script execution
• Detail environment layering: show how env drives target paths and how .benv.priv is optionally loaded