Files
omarchy-nix/README.md
T
Henry Sipp cd4e9e7c0d Cleanup
2025-06-28 13:00:42 -05:00

61 lines
2.1 KiB
Markdown

# Omarchy Nix
Omarchy-nix is an opinionated NixOS flake to help you get started as fast as possible with NixOS and Hyprland. It is primarily reimplementation of [DHH's Omarchy](https://github.com/basecamp/omarchy) project - an opinionated Arch/Hyprland setup for modern web development.
## Quick Start
To get started you'll first need to set up a fresh [NixOS](https://nixos.org/) install. Just download and create a bootable USB and you should be good to go.
Once ready, add this flake to your system configuration, you'll also need [home-manager](https://github.com/nix-community/home-manager) as well:
```nix
{
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-25.05";
omarchy-nix = {
url = "github:henrysipp/omarchy-nix";
inputs.nixpkgs.follows = "nixpkgs";
inputs.home-manager.follows = "home-manager";
};
home-manager = {
url = "github:nix-community/home-manager";
inputs.nixpkgs.follows = "nixpkgs";
};
};
outputs = { nixpkgs, omarchy-nix, home-manager, ... }: {
nixosConfigurations.your-hostname = nixpkgs.lib.nixosSystem {
modules = [
omarchy-nix.nixosModules.default
home-manager.nixosModules.home-manager #Add this import
{
# Configure omarchy
omarchy = {
full_name = "Your Name";
email_address = "your.email@example.com";
theme = "tokyo-night";
};
home-manager = {
users.your-username = {
imports = [ omarchy-nix.homeManagerModules.default ]; # And this one
};
};
}
];
};
};
}
```
## Configuration Options
I've specified some basic configuration options to help you get started with initial setup, as well as some simple overrides for common configuration settings I found I was modifying often. These are likely subject to change with future versions as I iron things out.
Refer to [the root configuration](https://github.com/henrysipp/omarchy-nix/blob/main/config.nix) file for more information on what options are available.
## License
This project is released under the MIT License, same as the original Omarchy.