Skip to content

README.md

Latest commit

 

History

History
87 lines (61 loc) · 1.89 KB

README.md

File metadata and controls

87 lines (61 loc) · 1.89 KB
Raw

Tibor's dotfiles

About

Personal configuration for my development environment, managed with GNU Stow.

  • Editor: Neovim
  • Multiplexer: Tmux
  • Prompt: Starship
  • Runtime manager: Mise
  • Shell: Zsh
  • Terminal: Alacritty
  • Theme: Gruvbox
  • Window manager: i3 (Linux); Aerospace (macOS)

Installation

1. Clone the repository

mkdir -p ~/Code/github.com/tiborsimko
git clone git@github.com:tiborsimko/dotfiles ~/Code/github.com/tiborsimko/dotfiles
cd ~/Code/github.com/tiborsimko/dotfiles

2. Install software

On Debian 13, you can use the install.sh helper script to provision software:

./install.sh            # see help
./install.sh base-cli   # CLI packages
./install.sh base-gui   # GUI packages (optional)
./install.sh mise       # Runtime version manager
...                     # etc

On other Linux distributions or on macOS, install equivalent packages via the native package manager.

3. Configure software

Run ./stow.sh all to link the enabled dotfiles:

./stow.sh all

Alternatively, to activate a single package by hand:

./stow.sh tmux

4. Install mise-managed toolchain

Once the dotfiles are linked, install the development tools managed by Mise, i.e. helm, kubectl, lazygit, nvim, several Python versions, etc:

./install.sh mise-tools

Testing

A disposable container provides a sandbox for verifying changes without touching the host:

make docker-build    # Build the test image
make docker-test     # Run dotfiles verification inside the container
make docker-run      # Open an interactive shell in the container

The repo is bind-mounted into the container, so host edits are visible without rebuilds.

The same verification can be run directly on the host:

./test.sh

License

See LICENSE.