Merge branch 'main' of https://github.com/noctalia-dev/noctalia-docs

Author: Ly-sec

src/content/docs/getting-started/installation.mdx

@@ -175,7 +175,7 @@ sudo xbps-install noctalia-shell
 This will automatically pull in `noctalia-qs` (the Quickshell runtime) as a dependency. If you only want the Quickshell fork without the shell config, install `noctalia-qs` instead.
 
 :::note
-If you have an existing `quickshell` or `quickshell-git` package installed, you must remove it first as `noctalia-qs` conflicts with it:
+If you already have the `quickshell` or `quickshell-git` package installed, you must remove it first as `noctalia-qs` conflicts with it:
 ```bash
 sudo xbps-remove quickshell
 ```
@@ -228,13 +228,13 @@ mkdir -p ~/.config/quickshell/noctalia-shell && curl -sL https://github.com/noct
 **Hardware-specific:**
 
 - `ddcutil` - Desktop monitor brightness control (⚠️ may introduce system instability with certain monitors)
+- `power-profiles-daemon` - Enables power profile selection
 
 **Optional but recommended:**
 
 - `cliphist` - Clipboard history support
-- `cava` - Audio visualizer component
 - `wlsunset` - Night light functionality
-- `xdg-desktop-portal` - Enables "Portal" option in screen recorder
+- `xdg-desktop-portal` - Enables screen sharing and file picker functionality
 - `python3`, `evolution-data-server` - Calendar events
 
 :::tip

src/content/docs/getting-started/nixos.mdx

@@ -6,6 +6,7 @@ sidebar:
 ---
 
 import SettingsReference from '../../../components/SettingsReference.astro';
+import { Tabs, TabItem } from '@astrojs/starlight/components';
 
 
 For NixOS users, a [Nix package](https://search.nixos.org/packages?channel=unstable&show=noctalia-shell) for Noctalia is available.
@@ -85,6 +86,39 @@ Rebuild with `sudo nixos-rebuild switch --flake .`.
 
 ---
 
+### Binary Cache {#binary-cache}
+
+Pre-built binaries are available on [Cachix](https://app.cachix.org/cache/noctalia), so you can skip compiling locally.
+
+You can add the cache either to your flake, nixos configuration, or `/etc/nix/nix.conf`.
+
+<Tabs>
+  <TabItem label="flake.nix">
+    ```nix
+    nixConfig = {
+      extra-substituters = [ "https://noctalia.cachix.org" ];
+      extra-trusted-public-keys = [ "noctalia.cachix.org-1:pCOR47nnMEo5thcxNDtzWpOxNFQsBRglJzxWPp3dkU4=" ];
+    };
+    ```
+  </TabItem>
+  <TabItem label="configuration.nix"> 
+    ```nix
+    nix.settings = { 
+      extra-substituters = [ "https://noctalia.cachix.org" ]; 
+      extra-trusted-public-keys = [ "noctalia.cachix.org-1:pCOR47nnMEo5thcxNDtzWpOxNFQsBRglJzxWPp3dkU4=" ]; 
+    };
+    ``` 
+  </TabItem>
+  <TabItem label="nix.conf"> 
+    ```conf
+    extra-substituters = https://noctalia.cachix.org
+    extra-trusted-public-keys = noctalia.cachix.org-1:pCOR47nnMEo5thcxNDtzWpOxNFQsBRglJzxWPp3dkU4=
+    ``` 
+  </TabItem>
+</Tabs>
+
+---
+
 ## Config with home-manager
 
 If you have [home manager](https://github.com/nix-community/home-manager) installed, you can configure your Noctalia shell in Nix.