Skip to content

README.md

Latest commit

 

History

History
200 lines (162 loc) · 6.1 KB

README.md

File metadata and controls

200 lines (162 loc) · 6.1 KB
Raw

dotfiles

Shell configuration, install scripts, and desktop environment configs for macOS and Linux.

Platforms

Platform Package Manager WM Terminal Shell
macOS Homebrew (brew) yabai + skhd Ghostty Bash + Starship
Linux Desktop (CachyOS) pacman + yay Hyprland Ghostty Bash + Starship
Linux Server (Ubuntu 24.04) apt Hyprland Ghostty Bash + Starship

See macos/README.md and linux/README.md for platform-specific details.

Setup

Quick start (new machine)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/sirwilliam15/dotfiles/HEAD/setup.sh)"

This installs Xcode CLI tools, Homebrew, git, and bash, then clones the repo to ~/.dotfiles.

Manual

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

install.sh detects the platform via $OSTYPE and symlinks the appropriate configs. Existing files are backed up with a timestamp before overwriting.

Package installation

source cli.sh
dotfiles install <list>    # e.g. "terminal", "desktop"

On macOS this uses brew with macos/brew.json. On Linux it detects apt/dnf from /etc/os-release and reads linux/pkg.txt.

Color Palette

Base Theme: Everforest + Nord Blend

A custom palette blending the warm greens and earth tones of Everforest with the cool blue-grey accents of Nord.

Everforest Reference Colors (Dark Hard variant)

Background:  #1e2326
Surface:     #272e33
Overlay:     #2d3b41
Muted:       #543a48
Subtle:      #7a8478
Text:        #d3c6aa
Green:       #a7c080
Teal:        #83c092
Blue:        #7fbbb3
Yellow:      #dbbc7f
Orange:      #e69875
Red:         #e67e80
Purple:      #d699b6

Nord Accent Colors (to blend in)

Nord Frost 1 (blue-grey): #8fbcbb
Nord Frost 2 (cyan):      #88c0d0
Nord Frost 3 (light blue):#81a1c1
Nord Frost 4 (deep blue): #5e81ac
Nord Snow 1 (off-white):  #d8dee9

Blending Intent

  • Backgrounds & surfaces: Use Everforest darks (#1e2326, #272e33)
  • Borders & active indicators: Use Nord Frost blues (#81a1c1, #5e81ac) as primary accent
  • Text: Everforest text (#d3c6aa) — warm, readable
  • Workspace indicators & highlights: Nord Frost or Everforest Green (#a7c080)
  • Inactive borders: Everforest Muted (#543a48) or Subtle (#7a8478)
  • Urgency/alerts: Everforest Red (#e67e80)

Applied consistently across: Hyprland borders, Waybar CSS, Rofi theme, hyprlock, swaync CSS, Ghostty palette, JankyBorders, Starship prompt, VS Code theme, and SDDM.

Theme reference files are in theme/ref/.

Fonts

Role Font Notes
UI font (Waybar, Rofi, GTK) Geist Mono Monospace; use for UI labels and bar text
Terminal font CaskaydiaCove Nerd Font No ligatures; clean, readable
Fallback / emoji Noto Sans + Noto Color Emoji Broad Unicode coverage
Icon glyphs (Waybar) Nerd Fonts Symbols For status bar icons

Ligatures: Disabled everywhere. No font-feature-settings for ligatures in terminal config.

Terminal & Shell

Terminal: Ghostty

  • Config: ghostty (symlinked to ~/.config/ghostty/config)
  • Everforest + Nord color palette baked into the config
  • CaskaydiaCove Nerd Font, size 13, ligatures off
  • Platform differences handled in the config (e.g. window-decoration = true on macOS, false on Linux)

Shell: Bash + Starship

  • Prompt config: theme/starship.toml (symlinked to ~/.config/starship.toml)
  • Shared aliases and functions: rc_common.sh (sourced by platform-specific .bashrc)
  • Platform .bashrc files: macos/.bashrc, linux/.bashrc

Starship Prompt

# Two-line prompt with git info
# Colors: Everforest green (directory), Nord blue (branch), Everforest red (status)
format = """
[╭─](bold green)$directory$git_branch$git_status$cmd_duration
$line_break
[╰─](bold green)$character"""

Theme Files

File Purpose
theme/starship.toml Starship prompt config (shared)
theme/vscode/ VS Code/VSCodium Everforest-Nord theme extension
theme/nvim-everforest-nord.lua Neovim colorscheme
theme/obsidian.css Obsidian theme snippet
theme/logseq.css Logseq theme snippet
theme/ref/ Color palette reference files

Directory Structure

dotfiles/
├── install.sh              # Platform-detecting installer (symlinks + backup)
├── cli.sh                  # Package installer helper (brew/apt/dnf)
├── rc_common.sh            # Shared shell config (aliases, env, starship init)
├── ghostty                 # Ghostty config (shared, macOS + Linux)
├── scripts/
│   ├── configure-repo.sh
│   ├── rebase.sh
│   └── spaces.sh           # macOS workspace switching
├── theme/
│   ├── starship.toml
│   ├── logseq.css
│   ├── obsidian.css
│   ├── nvim-everforest-nord.lua
│   ├── vscode/
│   │   ├── package.json
│   │   └── everforest-nord-theme.json
│   └── ref/
│       ├── everforest-dark.md
│       ├── everforest-nord-blend.md
│       └── nord-dark.md
├── macos/
│   ├── README.md
│   ├── .bashrc
│   ├── .skhdrc
│   ├── .yabairc
│   ├── brew.json
│   └── yabai/
│       ├── yabairc
│       ├── bordersrc
│       └── sketchybar/
└── linux/
    ├── README.md
    ├── .bashrc
    ├── pkg.txt
    ├── hypr/
    │   ├── hyprland.conf
    │   ├── hyprlock.conf
    │   ├── hypridle.conf
    │   └── hyprpaper.conf
    ├── waybar/
    │   ├── config.jsonc
    │   └── style.css
    ├── rofi/
    │   ├── config.rasi
    │   └── themes/everforest-nord.rasi
    ├── swaync/
    │   ├── config.json
    │   └── style.css
    ├── tmux/
    │   └── tmux.conf
    └── gtk/
        ├── gtk-3.0/settings.ini
        └── gtk-4.0/settings.ini