# SerenityOS
_Declarative NixOS configuration with Flakes & Home Manager_
[](https://nixos.org)
[](https://codeberg.org/Serenity-F/SerenityOS/src/branch/main/LICENSE)

## ✨ Key Features
- 🎨 **Unified Theming** with Stylix
- 🪟 **Niri** with ReGreet session management
- 🏠 **Home Manager** for declarative user environments
- 📦 **Modular Architecture** for easy customization
## 💻 System Information
### Software Stack
| Component | Implementation |
| ------------------ | ------------------------------------ |
| **OS** | NixOS Unstable |
| **Display Server** | Wayland |
| **Window Manager** | Niri + ReGreet |
| **Desktop** | Noctalia |
| **Terminal** | Kitty |
| **Shell** | Fish |
| **Editor** | Helix |
| **Browser** | Firefox |
| **File Manager** | Yazi |
| **Theme** | Stylix |
| **Filesystem** | Ext4 + ZFS |
## 🛠️ System Management
### Common Commands
| Command | Description |
| ------------------------------------------ | -------------------------------------------------- |
| `git add --all && git commit -m ""`| Save system changes to git tree |
| `nix flake update` | Update all flake inputs manually |
| `nix flake check` | Validate flake configuration |
| `sudo nixos-rebuild switch --flake .#`| Apply system changes |
| `sudo nixos-rebuild test --flake .#` | Test configuration without switching |
| `sudo nixos-rebuild boot --flake .#` | Build and set for next boot |
## 🤝 Contributing
While this is a personal configuration, suggestions and improvements are welcome!
- Open an issue for bugs or questions
- Submit PRs for improvements
- Share your own configs inspired by this setup
## 📝 Dev Notes
For the purposes of authenticity and earnestness:
- I will not rebase or squash any commits
- I will not remove any outdated branches
## 📜 License
MIT License - feel free to use and modify as you wish.
## 📚 Learning Resources
- [NixOS Manual](https://nixos.org/manual/nixos/stable/)
- [Nix Pills](https://nixos.org/guides/nix-pills/)
- [Home Manager Manual](https://nix-community.github.io/home-manager/)
- [Niri flake](https://github.com/epireyn/niri-flake)
- [Stylix Documentation](https://stylix.danth.me/)
_Built with ❤️ and lots of ☕_
**[⭐ Star this repo](https://codeberg.org/Serenity-F/SerenityOS) if you found it helpful!**