added wallpapers and catppuccin as the theme

.gitignore

@@ -0,0 +1 @@
+/result

README.md

@@ -1,66 +1,76 @@
-# Nixos Configuration
+# NixOS configuration
 
 ## Overview
 
-This documentation provides an overview of the NixOS configuration setup, including flake configuration, system configuration, user configuration, and Home Manager integration.
+This repository contains a flake-based NixOS setup with integrated Home Manager. It defines multiple hosts and composes user programs and development tooling via reusable Home Manager modules.
 
-## `flake.nix`
+## Repository layout
 
-### Description
-The `flake.nix` file serves as the main entry point for the NixOS configuration flake.
+- `flake.nix`: Flake entrypoint. Declares inputs like `nixpkgs`, `home-manager`, `nixos-hardware`, `nix-topology`, `spicetify-nix`, `zen-browser`, and wires outputs.
+- `hosts/`
+  - `shadow/`
+    - `configuration.nix`: System configuration for host `shadow` (imports Home Manager).
+    - `hardware-configuration.nix`: Auto-generated by `nixos-generate-config`.
+    - `home.nix`: User-specific Home Manager configuration for `danny` on `shadow`.
+- `modules/home-manager/`
+  - `development/`
+    - `default.nix`: Aggregates development modules.
+    - `ides.nix`: IDE packages (e.g., `neovim`, `code-cursor-fhs`).
+    - `tools.nix`: CLI/dev tools configuration.
+    - `zeditor.nix`: Additional editor-related config.
+  - `programs/`
+    - `default.nix`: Aggregates program modules.
+    - `misc/`: Assorted program configs (e.g., `bat.nix`, `git.nix`, `kitty.nix`, `lf.nix`, `nushell.nix`, `obsidian.nix`, `spotify.nix`).
+    - `mpv/`: MPV player configuration.
+    - `zathura/`: Zathura PDF viewer configuration.
+- `topology.nix`: Network/service topology using `nix-topology` overlay.
 
-### Inputs
-- `nixpkgs`: Nixpkgs repository for NixOS unstable.
-- `home-manager`: Integration of Home Manager for user-specific configurations.
-- `hyprland`: Package necessary for the Window Manager configuration.
+## Flake outputs
 
-### Outputs
-- `nixosConfigurations`: Defines system configurations.
+- `nixosConfigurations.shadow`: Main laptop configuration (ThinkPad T490 hardware module).
+- `nixosConfigurations.reaper`: PC configuration.
+- `topology.x86_64-linux`: Topology output generated from `topology.nix` and hosts.
 
-## `configuration.nix` (hosts/shadow)
+## Quickstart
 
-### System Configuration
-- Bootloader, Filesystems, Networking, Time Zone, Internationalization, Services, Programs, Security, Fonts, User Account.
+1. Clone your repo and enter it:
 
-### Home Manager Integration
-- Manages user-specific configurations.
+   ```bash
+   git clone <this-repo-url>
+   cd shadow
+   ```
 
-## `home.nix` (hosts/shadow)
+2. Build and switch for a host (example: `shadow`):
 
-### User Configuration
-- Sets username, home directory, and additional packages.
-- Defines session variables and enables Home Manager.
+   ```bash
+   sudo nixos-rebuild switch --flake .#shadow
+   ```
 
-## `hardware-configuration.nix`
+3. For another host (example: `reaper`):
 
-- Automatically generated file containing hardware configuration.
+   ```bash
+   sudo nixos-rebuild switch --flake .#reaper
+   ```
 
-## Home Manager Modules
+Home Manager is integrated via `home-manager.nixosModules.default`, so user configuration under `hosts/<host>/home.nix` is applied as part of the system rebuild.
 
-- `development/default.nix`: IDEs and development tools.
-- `development/ides.nix`: IDE configurations.
-- `development/tools.nix`: Development tools configurations.
-- `programs/default.nix`: Miscellaneous programs.
-- `programs/alacritty/default.nix`: Alacritty terminal configuration.
-- `programs/misc/*.nix`: Miscellaneous program configurations.
-- `programs/zsh/default.nix`: Zsh shell configuration.
+## Common tasks
 
-## Instructions for Replication
+- Update inputs and rebuild:
 
-1. **Clone the Repository**: Clone your NixOS configuration repository to your local machine.
+  ```bash
+  nix flake update
+  sudo nixos-rebuild switch --flake .#shadow
+  ```
 
-   ```bash
-   git clone https://github.com/enchanted-coder/nix-config/
-   ```
-
-1. **Navigate to Configuration Directory**: Move to the directory containing your NixOS configuration files.
+- Build without switching (dry-run build):
 
-   ```bash
-   cd <repository_directory>/nixos-config/
-   ```
+  ```bash
+  nix build .#nixosConfigurations.shadow.config.system.build.toplevel
+  ```
 
-1. **Build and Activate Configuration**: Run the following command to build and activate your NixOS configuration.
+## Notes
 
-   ```bash
-   nixos-rebuild switch --flake .#shadow
-   ```
+- Hardware-specific modules are included via `nixos-hardware` (e.g., `lenovo-thinkpad-t490`).
+- `nix-topology` overlay is enabled in `flake.nix` and used by `topology.nix` for visualization/analysis.
+- Some development modules (e.g., `neovim.nix`, `vscode.nix`) are present but may be commented out in `development/default.nix`; enable as needed.