https://github.com/ryan4yin/nix-darwin-kickstarter

macOS as Code! A beginner-friendly nix-darwin + home-manager + flakes startup configuration. 一份易于理解的 nix-darwin 初始配置模板，专为新手制作.
https://github.com/ryan4yin/nix-darwin-kickstarter

darwin dotfiles flakes home-manager macos nix starter-template

Last synced: 4 days ago
JSON representation

macOS as Code! A beginner-friendly nix-darwin + home-manager + flakes startup configuration. 一份易于理解的 nix-darwin 初始配置模板，专为新手制作.

• Host: GitHub
• URL: https://github.com/ryan4yin/nix-darwin-kickstarter
• Owner: ryan4yin
• License: mit
• Created: 2023-07-19T05:12:52.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-04T00:29:34.000Z (3 months ago)
• Last Synced: 2025-01-12T23:00:46.823Z (11 days ago)
• Topics: darwin, dotfiles, flakes, home-manager, macos, nix, starter-template
• Language: Nix
• Homepage:
• Size: 204 KB
• Stars: 458
• Watchers: 7
• Forks: 36
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nix Darwin Kickstarter

A beginner-friendly nix-darwin + home-manager + flakes startup configuration.

The primary objective of this repository is to assist beginners in comprehending the fundamental setup of nix-darwin, enabling them to swiftly initiate their own nix-darwin configuration.

Two template versions are available:

- [minimal](./minimal): A basic configuration comprising essential settings for initiating nix-darwin. It can be safely deployed to your system.

- [rich-demo](./rich-demo): An extensive demo featuring a plethora of configurations that can serve as a reference for your setup. However, exercise caution, as it may **OVERWRITE** your system configuration. **DO NOT** deploy it directly to your system.

## Why nix-darwin

Nix-darwin facilitates the management of your macOS system configuration and dotfiles in a declarative manner.

You can effortlessly revert to any previous configuration, making it a robust tool for system customization.

Sharing configurations becomes seamless, and managing multiple macOS hosts is a breeze with nix-darwin.

## Showcases

Enable TouchID for sudo with just one line:

![](./_img/nix-darwin-enable-touchid.webp)

Customize (Almost) all your macOS settings via nix-darwin:

![](./_img/customize-your-macos.webp)

## References

- [LnL7/nix-darwin](https://github.com/LnL7/nix-darwin)

- [macos-defaults](https://github.com/yannbertrand/macos-defaults)

- [ryan4yin/nix-config/modules/darwin](https://github.com/ryan4yin/nix-config/tree/main/modules/darwin)