Dotfiles Configuration

Introduction

This repository contains my personal dotfiles and system configuration for macOS using Nix and Nix-Darwin.

Features

• System-wide package management with Nix
• Declarative system configuration with Nix-Darwin
• Home directory configuration with Home Manager
• Git configuration management
• Shell environment setup

Prerequisites

System Requirements

• macOS 10.15 (Catalina) or later
• Administrative privileges
• Xcode Command Line Tools installed

Required Tools

• Nix Package Manager
• Nix-Darwin
• Home Manager

Installation Steps

Install dotfiles with stow:

stow .

Install Nix Package Manager

sh <(curl -L https://nixos.org/nix/install)

Install Nix-Darwin

cd /nix-darwin

# Initialize flake
nix flake init -t nix-darwin

# Build initial configuration
nix build .#mini

# Create first generation
darwin-rebuild switch --flake .#mini

Configuration

The configuration is organized into the following directories:

• git/: Git configuration files
• nix/: Nix package manager configuration
• nix-darwin/: System configuration using Nix-Darwin

Troubleshooting

Common issues and solutions:

1. Permission errors: Run commands with sudo when necessary
2. Broken packages: Try running nix-collect-garbage -d to clean up old packages

References

Official Documentation

• Nix Package Manager
• Nix-Darwin
• Home Manager

Community Resources

• NixOS Wiki
• Nix Pills
• Awesome Nix

Tutorials & Guides

• Getting started with Nix on MacOS
• macOS Setup Guide
• Declarative macOS Configuration