Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/shawal-mbalire/dotfiles/llms.txt

Use this file to discover all available pages before exploring further.

​
Initial Setup

You can install the dotfiles using either the quick install script or manual method.

​
Quick Install (Single Command)

curl -fsSL https://raw.githubusercontent.com/shawal-mbalire/dotfiles/main/install.sh | bash

​
Manual Install

git clone https://github.com/shawal-mbalire/dotfiles
rsync -avhu --progress dotfiles/ ~/

​
Hyprland Installation

Install Hyprland and essential utilities using yay. 
yay -Syyu hyprland-git wofi drun

​
Complete Hyprland Environment

For a full setup with all components, you may want to install additional packages: 
yay -S hyprland hyprlock hypridle hyprpaper

​
Nerd Fonts

Install Hack Nerd Font for terminal icons and glyphs. 
yay -S ttf-hack-nerd

​
Alternative: JetBrainsMono Nerd Font

Download and install JetBrainsMono Nerd Font manually: 
curl -OL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.tar.xz
Extract to ~/.local/share/fonts/ or /usr/share/fonts/.

​
Essential Packages

Install commonly used tools and applications.

​
Terminal and Shell

yay -S fish kitty

​
Window Manager Utilities

yay -S rofi waybar

​
System Utilities

yay -S blueman pavucontrol nm-applet

​
Development Tools

yay -S gh neovim

​
File Management

yay -S exa nautilus

​
Application Installations

​
Snaps

sudo snap install obsidian
sudo snap install code --classic

​
Flatpaks

flatpak install flathub io.github.zen_browser.zen

​
Neovim Setup

​
Installing Packer (Plugin Manager)

git clone --depth 1 https://github.com/wbthomason/packer.nvim\
 ~/.local/share/nvim/site/pack/packer/start/packer.nvim

​
Vim Plug (Alternative)

If you prefer Vim Plug over Packer:

​
For Neovim

sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
  https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

​
For Vim

curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
  https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

​
Tmux Setup

Install Tmux Plugin Manager: 
git clone https://github.com/tmux-plugins/tpm ~/.config/tmux/plugins/tpm
After installation, launch tmux and press prefix + I (capital i) to install plugins.

​
Using yay vs pacman

  • pacman: Official package manager for Arch Linux, installs packages from official repositories
  • yay: AUR (Arch User Repository) helper that can install both official and AUR packages
  • Use yay when you need AUR packages or want a unified interface
  • Use sudo pacman -S for official repository packages if you prefer

​
Installing yay

If you don’t have yay installed: 
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

Build docs developers (and LLMs) love

Get started for freeTalk to us