https://github.com/catppuccin/nix
❄️ Soothing pastel theme for Nix
https://github.com/catppuccin/nix
catppuccin hacktoberfest home-manager nix nix-flake nixos theme
Last synced: 13 days ago
JSON representation
❄️ Soothing pastel theme for Nix
- Host: GitHub
- URL: https://github.com/catppuccin/nix
- Owner: catppuccin
- License: mit
- Created: 2023-03-27T01:56:44.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T12:39:42.000Z (15 days ago)
- Last Synced: 2025-04-11T14:14:22.869Z (15 days ago)
- Topics: catppuccin, hacktoberfest, home-manager, nix, nix-flake, nixos, theme
- Language: Nix
- Homepage: https://nix.catppuccin.com/
- Size: 2.29 MB
- Stars: 505
- Watchers: 6
- Forks: 61
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - catppuccin/nix - ❄️ Soothing pastel theme for Nix (Nix)
- awesome-starred - catppuccin/nix - ❄️ Soothing pastel theme for Nix (Nix)
README
Catppuccin for Nix
## Previews
🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha
## Usage
You will probably want to see our [Getting started guide](http://nix.catppuccin.com/getting-started/index.html), but as a TLDR:
1. Import the [NixOS](https://nixos.org) and [home-manager](https://github.com/nix-community/home-manager) modules
With Flakes
```nix
{
inputs = {
nixpkgs.url = "nixpkgs/nixos-unstable";
catppuccin.url = "github:catppuccin/nix";
home-manager = {
url = "github:nix-community/home-manager";
inputs.nixpkgs.follows = "nixpkgs";
};
};
outputs = { nixpkgs, catppuccin, home-manager }: {
# for nixos module home-manager installations
nixosConfigurations.pepperjacksComputer = pkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
catppuccin.nixosModules.catppuccin
# if you use home-manager
home-manager.nixosModules.home-manager
{
# if you use home-manager
home-manager.users.pepperjack = {
imports = [
./home.nix
catppuccin.homeManagerModules.catppuccin
];
};
}
];
};
# for standalone home-manager installations
homeConfigurations.pepperjack = home-manager.lib.homeManagerConfiguration {
pkgs = nixpkgs.legacyPackages.x86_64-linux;
modules = [
./home.nix
catppuccin.homeManagerModules.catppuccin
];
};
};
}
```
With Nix Channels
```bash
sudo nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
sudo nix-channel --add https://github.com/catppuccin/nix/archive/main.tar.gz catppuccin
sudo nix-channel --update
```
For [NixOS module installations](https://nix-community.github.io/home-manager/index.html#sec-install-nixos-module):
```nix
{
imports = [
# if you use home-manager
];
# if you use home-manager
home-manager.users.pepperjack = {
imports = [
];
};
}
```
For [standalone installations](https://nix-community.github.io/home-manager/index.html#sec-install-standalone)
```nix
{
imports = [
];
home.username = "pepperjack";
programs.home-manager.enable = true;
}
```
2. In your configuration, choose your desired flavor with `catppuccin.flavor`
```nix
{
catppuccin.flavor = "mocha";
}
```
3. Enable for supported programs
```nix
{
catppuccin.starship.enable = true;
}
```
4. Enable for all available programs you're using!
```nix
{
catppuccin.enable = true;
}
```
## 🙋 FAQ
- Q: **"How do I know what programs are supported?"**\
A: You can find programs supported through home-manager [here](https://nix.catppuccin.com/search/rolling/?scope=home-manager+modules),
and NixOS modules [here](https://nix.catppuccin.com/search/rolling/?scope=NixOS+modules)
- Q: **"How do I set `catppuccin.enable` for everything I use?"**\
A: You can set `catppuccin.enable` globally through home-manager [here](https://nix.catppuccin.com/search/rolling/?option_scope=1&option=catppuccin.enable),
and NixOS modules [here](https://nix.catppuccin.com/search/rolling/?option_scope=0&option=catppuccin.enable)
- Q: **"What versions of NixOS and home-manager are supported?"**\
A: We primarily support the `unstable` branch, but try our best to support the current stable release.
You can check if your stable release is currently supported at [status.nixos.org](https://status.nixos.org/)
- Q: **"How do I fix the error: ... during evaluation because the option 'allow-import-from-derivation' is disabled"**\
A: Some ports need to read and/or manipulate remote resources, resulting in Nix performing [IFD](https://nix.dev/manual/nix/latest/language/import-from-derivation).
We try to avoid this where possible, but sometimes we need to use it. Check out [our tracking issue](https://github.com/catppuccin/nix/issues/392) to see what ports are affected.
- Q: **"How do I fix the error: a '...' with features {} is required to build '...'"?**\
A: See the above
## 💝 Thanks to
- [Stonks3141](https://github.com/Stonks3141)
- [getchoo](https://github.com/getchoo)
Copyright © 2023-present Catppuccin Org
