A comprehensive, production-ready dotfiles repository for Arch Linux featuring Hyprland, Noctalia Shell, and the Tokyo Night color scheme. Fully automated installation with professional tooling for modern development workflows.

• Window Manager: Hyprland (Dynamic tiling Wayland compositor)
• Desktop Shell: Noctalia Shell (Modern, feature-rich shell)
• Color Scheme: Tokyo Night (Consistent across all applications)
• Font: JetBrains Mono Nerd Font (Coding ligatures + icons)
• Cursor Theme: Bibata Modern Ice
• Icons: Papirus + Font Awesome

• Shell: ZSH with Oh My Zsh
• Prompt: Starship (Fast, customizable)
• Multiplexer: tmux with custom Tokyo Night theme
• Emulators: Ghostty, Kitty, Alacritty, WezTerm, Foot

• Editor: Neovim (Extensive Lua configuration with LSP, Treesitter, Telescope)
• Version Control: Git + Lazygit + GitHub CLI
• Languages: Go, Rust, Node.js, Python, C/C++
• Containers: Docker + Docker Compose + Lazydocker
• IDEs: VS Code, Cursor

• Fresh Arch Linux installation
• Internet connection
• Sudo privileges

# Clone the repository
git clone https://github.com/yourusername/dot-files.git ~/.dotfiles
cd ~/.dotfiles

# Run the installation
./bootstrap.sh

Note: The bootstrap.sh script is already executable. If you only want to install packages without dotfiles setup, use ./arch/install.sh instead.

Full Installation (Recommended):

./bootstrap.sh

Packages Only (Lightweight):

./arch/install.sh
# Only installs packages from packages.txt without dotfiles

Custom Installation (Choose components):

./bootstrap.sh
# Then select option 2 from the menu

Skip Specific Components:

./bootstrap.sh --no-packages    # Skip package installation
./bootstrap.sh --no-dotfiles    # Skip dotfiles setup
./bootstrap.sh --no-shell       # Skip shell configuration
./bootstrap.sh --no-nvim        # Skip Neovim setup
./bootstrap.sh --no-hyprland    # Skip Hyprland setup
./bootstrap.sh --no-themes      # Skip theme installation

1. AUR Helper: yay (for AUR package management)
2. System Packages: 100+ packages from packages.txt
3. Dotfiles: Symlinked via GNU Stow
4. Shell Environment: ZSH + Oh My Zsh + plugins + Starship
5. Neovim: Full IDE-like setup (plugins install on first launch)
6. Hyprland: Complete Wayland environment
7. Fonts & Themes: JetBrains Mono Nerd Font + Tokyo Night + Bibata cursors

reboot

Login and choose "Hyprland" session

Default terminal: Ghostty (or kitty, alacritty)

nvim
# Lazy.nvim will auto-install plugins on first launch

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

ssh-keygen -t ed25519 -C "[email protected]"

Edit respective config files:

• Hyprland: .config/hypr/hyprland.conf
• Neovim: .config/nvim/lua/config/plugins/colorscheme.lua
• Tmux: .tmux.conf
• Terminal: Individual terminal configs in .config/

Edit arch/packages.txt and run:

cd ~/.dotfiles
./bootstrap.sh --no-dotfiles --no-shell --no-nvim --no-hyprland --no-themes

Create ~/.config/zsh/local.zsh for personal shell settings (gitignored).

Switch between work and personal Git accounts:

# Switch to work profile
./scripts/git-switch.sh work

# Switch to personal profile
./scripts/git-switch.sh personal

Record your screen with optional audio:

./scripts/record_screen.sh

.
├── bootstrap.sh              # Main installation script
├── install.sh                # Legacy installer (use bootstrap.sh)
├── README.md                 # This file
├── .stow-local-ignore        # Files to ignore when stowing
├── arch/
│   ├── install.sh            # Arch-specific installer
│   └── packages.txt          # Complete package list
├── scripts/
│   ├── git-switch.sh         # Git profile switcher
│   └── record_screen.sh      # Screen recorder
├── screenshots/              # Rice screenshots
├── .config/                  # Application configs
│   ├── nvim/                 # Neovim configuration
│   ├── hypr/                 # Hyprland configuration
│   ├── zsh/                  # Modular ZSH config
│   ├── ghostty/              # Ghostty terminal
│   ├── kitty/                # Kitty terminal
│   ├── alacritty/            # Alacritty terminal
│   ├── waybar/               # Status bar
│   ├── rofi/                 # Launcher
│   ├── dunst/                # Notifications
│   └── ...                   # Other app configs
├── .zshrc                    # ZSH entry point
├── .tmux.conf                # Tmux configuration
├── .vimrc                    # Vim configuration
└── .gitconfig                # Git configuration (template)

# Remove and reinstall
rm -rf ~/.local/share/nvim
nvim

# Check logs
cat /tmp/hypr/$(ls -t /tmp/hypr/ | head -n 1)/hyprland.log

# Rebuild font cache
fc-cache -fv

# Backup and remove conflicting files
mv ~/.zshrc ~/.zshrc.backup
cd ~/.dotfiles
stow --restow .

Contributions are welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests
• Share your customizations

This project is licensed under the MIT License - see the LICENSE file for details.

• Tokyo Night Theme
• Hyprland
• Neovim
• Oh My Zsh
• Noctalia Shell
• All the amazing open-source contributors

• GitHub: @2SSK
• Email: [email protected]