Skip to content

mauriciopoppe/dotfiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

514 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mauricio Poppe's dotfiles

platform macos platform linux

Core Stack

  • Ghostty: GPU-accelerated terminal emulator
  • Zsh: With Powerlevel10k and custom modules
  • Tmux: For session management
  • Neovim: IDE-like setup powered by Lazy.nvim

Features

  • Automated & Modular: Installation is fully automated via the dotfiles script. You can install the entire suite or just specific modules (e.g., dotfiles neovim, dotfiles ghostty).
  • Active Configuration: Unlike passive symlink managers like GNU Stow, this setup actively provisions your environment. It handles package installation (Homebrew, Apt, NPM), compiles dependencies, and sets system defaults within the same workflow.
  • Smart Adaptability: While tools like Chezmoi offer great templating, this setup provides full imperative control. It intelligently detects your environment—whether it's macOS or Linux and dynamically adjusts the cmd prompt, default editors, and paths to match.

Requirements

MacOS

  • XCode Command Line Tools, if you don't have it install it with xcode-select --install
  • zsh (installed by default on OSX)

Linux

  • zsh

Installation

cd ~
git clone https://github.com/mauriciopoppe/dotfiles .dotfiles
cd .dotfiles
source install.sh

The script above will add ~/.dotfiles/zsh/bin/ to your PATH for the current session

All operations are done through the dotfiles script

dotfiles --help
Important notes about the installer
make sure you read the install.zsh script and the README file included on each directory before executing $ dotfiles <command>
executing $ dotfiles <command> might symlink some files of this repo to your dotfiles, this script makes a backup of already existing files as [name].backup

For example if you want to install my configuration of tmux execute

dotfiles tmux

Which calls the install.zsh script located inside the tmux/ folder, you can do this with all the first level directories of this repo e.g. $ dotfiles [zsh|tmux|neovim|ghostty|...]

Post installation

What's included? And how to customize it?

Refer to the file install.zsh that each folder has, after cloning the repo you can add whatever you need inside each installation script

How do I use these tools?

I talk about my workflow in this article: https://www.mauriciopoppe.com/notes/misc/productivity-skills

Study links

Credits

Big parts of my dotfiles were inspired (in most cases copied :P) from other dotfiles, I wanna thank the following people for their contribution to the open source community

Thank you all!

2015-Present