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 Nix Package Manager

# Install Nix using Nix installer from Determinate Systems
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
  sh -s -- install

# To verify that Nix has been installed successfully,
nix-shell -p neofetch --run neofetch

Install Nix-Darwin

cd /nix-darwin

# Build initial configuration
nix run nix-darwin -- switch --flake .#mini

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

Configuration

The configuration is organized into the following directories:

• 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
• Declarative macOS Configuration