Skip to content

aessing/dotfiles

BranchesTags

Repository files navigation

Andre's Dotfiles

Personal configuration files for macOS, Linux, and GitHub Codespaces

Quick Start • What's Included • Scripts • Codespaces

🚀 Quick Start

Fresh macOS Installation

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/aessing/dotfiles/main/setup_macos.sh)"

This will install Homebrew, Git, clone the repo, install packages, apply macOS preferences, and symlink all dotfiles.

Existing Installation / Linux / Codespaces

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

📂 What's Included

Shell Configuration

File Description
.zshrc Main Zsh configuration
.zshenv Environment variables
.zprofile Login shell configuration
.zsh/ Modular Zsh scripts
Zsh Modules
Module Description
aliases.zsh Shell aliases and shortcuts
autocomplete.sh Zsh autosuggestions
azure_functions.zsh Azure Functions CLI
docker.zsh Docker CLI completions
dotnet.zsh .NET SDK configuration
functions.zsh Custom shell functions
homebrew.zsh Homebrew environment
monokai.zsh Syntax highlighting theme
monokai-style.zsh Monokai color definitions
nvm.zsh Node Version Manager
python.zsh Python/pyenv setup
starship.zsh Starship prompt with distro detection

Configuration Files

File Description
.gitconfig Git configuration with aliases
.config/starship/starship.toml Starship prompt (Monokai Pro theme)
.config/fastfetch/ Fastfetch system info configuration
.config/1Password/ssh/agent.toml 1Password SSH agent
.ssh/config SSH client configuration

Package Management

File Description
.Brewfile Personal Homebrew packages
.Brewfile.DBX Work Homebrew packages

Fonts

Nerd Fonts with icons for terminal:

  • CaskaydiaCove Nerd Font — Patched Cascadia Code
  • CaskaydiaMono Nerd Font — Monospace variant
  • JetBrains Mono Nerd Font — Developer typeface (currently using)

Themes

Monokai Pro themes for macOS Terminal.app:

Theme Variant
Monokai Classic Original
Monokai Pro Default
Monokai Pro (Filter Machine) Blue tint
Monokai Pro (Filter Octagon) Green tint
Monokai Pro (Filter Ristretto) Brown tint
Monokai Pro (Filter Spectrum) Purple tint (currently using)
Monokai Pro Light Light variant
Monokai Pro Light (Filter Sun) Warm light

More info: monokai.pro

💻 Scripts

setup_macos.sh

Full macOS bootstrap with interactive prompts:

./setup_macos.sh
  1. Install Homebrew
  2. Install Git
  3. Clone dotfiles repository
  4. Install packages from Brewfile (selectable)
  5. Apply macOS system preferences
  6. Symlink dotfiles

install.sh

Cross-platform dotfiles installer:

./install.sh [--force]
Option Description
--force Overwrite existing files without backup

Config/set-macOS-defaults.sh

Apply macOS system preferences:

./Config/set-macOS-defaults.sh

☁️ GitHub Codespaces

Automatic setup via .devcontainer/devcontainer.json:

  • Zsh as default shell
  • Starship prompt pre-installed
  • Zsh plugins — autosuggestions & syntax-highlighting
  • GitHub CLI (gh)
  • uv — fast Python package manager
  • specify-cli — spec-driven development
  • Dotfiles automatically symlinked

📁 Repository Structure

~/.dotfiles/
├── .Brewfile                     # Homebrew packages (personal)
├── .Brewfile.DBX                 # Homebrew packages (work)
├── .config/
│   ├── 1Password/ssh/agent.toml  # 1Password SSH agent
│   ├── fastfetch/                # Fastfetch configuration
│   └── starship/starship.toml    # Starship prompt
├── .devcontainer/
│   └── devcontainer.json         # Codespaces configuration
├── .gitconfig                    # Git configuration
├── .ssh/
│   └── config                    # SSH configuration
├── .zsh/                         # Modular Zsh configs
├── .zshenv                       # Environment variables
├── .zprofile                     # Login shell config
├── .zshrc                        # Main Zsh config
├── Config/
│   └── set-macOS-defaults.sh     # macOS preferences
├── Fonts/                        # Nerd Fonts
├── Themes/
│   └── monokai-pro-terminal/     # Terminal.app themes
├── install.sh                    # Cross-platform installer
├── setup_macos.sh                # macOS bootstrap
└── README.md

🛠️ Manual Installation

Fonts via Homebrew 
brew install --cask font-caskaydia-cove-nerd-font
brew install --cask font-caskaydia-mono-nerd-font
brew install --cask font-jetbrains-mono-nerd-font
Fonts Manual
  1. Navigate to Fonts/ directory
  2. Open desired font folder
  3. Double-click font files to install via Font Book (macOS)
Terminal Themes (macOS)
  1. Navigate to Themes/monokai-pro-terminal/
  2. Double-click .terminal file to import
  3. Set as default in Terminal → Preferences → Profiles

⭐ Credits

Inspired by Christian Lempa's Dotfiles.

📄 License & Support

For information about contributing, support, security, and licensing, please see the respective documents.

THE CONTENT OF THIS REPOSITORY IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

About

This repository contains my personal config files. Here you'll find configs, customizations, themes, and whatever I need to personalize my Linux and mac OS experience.

Topics

macos linux dotfiles dotfiles-macos dotfiles-linux

Resources

Readme

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

2 stars

Watchers

1 watching

Forks

0 forks
Report repository

Sponsor this project

 
Learn more about GitHub Sponsors

Contributors

Languages