Dotfiles

Welcome to my Nix Dotfiles, a configuration using Home Manager, featuring the COSMIC desktop, Catppuccin theme, and essential development tools.

Screenshots

Cosmic DE

Fastfetch

More Screenshots

Zellij

Helix with Yazi

Helix with Lazygit

Helix

Helix with Gemini

Tiles

Bottom

Cosmic Files and Nautilus

Nwg-drawer

Rofi

Swayimg

Swayimg Gallery

Installation

TLDR: I do not provide a magical script to transform your NixOS to mimic my config. Copy the individual program config from home/ directory and configure/modify it according to your own liking. I do not recommend switch.sh, it's for my own convenience.

Project Structure

├── home/                  # Home Manager setup
│   ├── flake.nix
│   ├── home.nix
│   ├── cosmic/            # Cosmic DE config (not nixified)
│   ├── helix/             # Helix editor config
│   ├── yazi/              # Yazi terminal file manager config
│   ├── zellij/            # Zellij TUI multiplexer config
│   └── ...                # Other Home Manager modules
├── system/                # System-level NixOS config
│   ├── configuration.nix
│   ├── flake.nix
│   └── virtualisation.nix
└── README.md

Home Manager

This configuration includes Home Manager for declarative user environment management. Home Manager allows you to manage user-specific packages, dotfiles, and services in a reproducible way.

To set up Home Manager:

1. Install and set up home-manager with flakes.
2. Configure user-specific settings and packages.
3. Copy the individual <program> directory from home/ directory. If you include or exclude any modules, make sure you edit modules = [...] in flake.nix.
4. Apply with: home-manager switch.

Helix as IDE

This setup features deep integration of Helix with Zellij, Yazi, and Lazygit:

• Helix: The post modern stable editor whose plugins don’t crash every other day because it doesn’t need 50 of them (or any) to be useful in the first place. All language configurations are managed in home/helix/language.nix for:
  • Rust, C, C++, Nix, Lua, Typst, Python, Bash, Dockerfile, Docker Compose, JavaScript, TypeScript, JSX, TSX, JSON, YAML, Markdown, HTML, CSS, SCSS, Svelte, TOML, PowerShell
  • Most of the language is configured with formatters and language servers.
• Yazi: Integrated as a file picker within Helix.
• Lazygit: Integrated as the Git UI inside Helix.
• Zellij: tHe InTEgRRattion: Used to open Yazi and Lazygit in floating panes, making them appear as native Helix popups for a unified workflow.
• LLM Integration: Gemini is integrated for AI-assisted tasks, available through floating Zellij panes. Note that this can be configured to work with any cli tool. Just edit the scripts in ./home/helix/default.nix.

Note

There's no LLM based autocompletion setup. I dislike those tools, and this Gemini is mostly for generatin commit messages and README files. If you want copilot like completion, look for helix-gpt.

Keybindings for LLM features:

• space + l + c: Open a chat session with Gemini.
• space + l + m: Generate a commit message based on the current changes.
• space + l + e: Explain the selected codebase.
• space + l + a: Analyze the code and suggest improvements.

Yazi and Lazygit are launched in context aware floating panes via Zellij, making them feel like native extensions of Helix. This tight integration allows seamless file navigation and Git operations without ever leaving the editor environment.

Credits & Acknowledgments

This configuration is built upon the excellent work of the following projects and their maintainers:

NixOS - The Nix Operating System that enables reproducible and declarative system configurations.

Cosmic DE - Customizable, and performant desktop environment built from scratch using Rust and the Iced toolkit.

Home Manager - Nix-based user environment configurator by the nix-community, enabling declarative management of user packages and dotfiles.

Helix - The post modern stable editor whose plugins don’t crash every other day because it doesn’t need 50 of them (or any) to be useful in the first place.

Zellij - A terminal workspace with batteries included.

Yazi - Blazing fast terminal file manager by sxyazi, written in Rust with async I/O.

Kitty - A fast, feature-rich, GPU-based terminal emulator.

Rofi - An application launcher and dmenu replacement.

Nwg-drawer - A GTK3-based application drawer for wlroots-based Wayland compositors. However this works in my smithay based COSMIC de rather well.

Catppuccin - Soothing pastel theme ecosystem maintained by the Catppuccin organization, providing consistent theming across multiple applications.

Starship - Cross-shell prompt by the Starship contributors, providing a fast and customizable command line prompt.

LazyGit - Simple terminal UI for git commands by jesseduffield, providing an intuitive interface for Git operations.

Delta - Syntax-highlighting pager for git by dandavison, enhancing git diff output with beautiful formatting.

Zsh – A fast, POSIX-compatible shell with sane scripting, proper interactivity, and plugin support that doesn’t fight you. No structured data fantasies, just a shell that gets out of the way and gets shit done.

License

This project is licensed under MIT license

Contributing

Feel free to open issues or submit pull requests if you have suggestions for improvements.