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

Author: Ly-sec

src/content/docs/v5/configuration/index.mdx

@@ -52,6 +52,8 @@ Noctalia loads configuration in this order:
 3. GUI-managed overrides in `~/.local/state/noctalia/settings.toml`
 
 Because `~/.local/state/noctalia/settings.toml` loads last, it wins when it contains the same setting as your config file.
+When Settings writes a value that matches the parsed value from the lower layers, Noctalia removes that redundant key
+instead of keeping it as a GUI override.
 
 :::tip
 If you are confused about why a value from `config.toml` is not taking effect, inspect or temporarily move `~/.local/state/noctalia/settings.toml`.

src/content/docs/v5/services/control-center.mdx

@@ -10,6 +10,7 @@ sidebar:
 ## Shortcuts
 
 The overview tab displays a row of shortcut buttons at the bottom. Up to 6 shortcuts are shown.
+You can also edit this list from **Settings → Panels → Control Center**.
 
 ```toml
 [[control_center.shortcuts]]
@@ -36,8 +37,6 @@ type = "session"
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
 | `type` | string | *required* | Shortcut type from the list below |
-| `label` | string | (per type) | Override the default label |
-| `icon` | string | (per type) | Override the default glyph with a Noctalia alias, Tabler icon name, or `U+` / `0x` codepoint |
 
 ### Available shortcut types
 
@@ -62,4 +61,5 @@ type = "session"
 
 Toggle shortcuts show an active/inactive visual state. `power_profile`, `weather`, and `keyboard_layout` display dynamic labels (current profile, temperature, or layout name).
 
-When no `[[control_center.shortcuts]]` entries are defined, the default set is: `wifi`, `bluetooth`, `nightlight`, `notification`, `wallpaper`, `caffeine`.
+When no `[[control_center.shortcuts]]` entries are defined, the default set is: `wifi`, `bluetooth`, `caffeine`, `nightlight`, `notification`, `power_profile`.
+Set `shortcuts = []` under `[control_center]` to hide all overview shortcut buttons.

src/content/docs/v5/shell.mdx

@@ -43,7 +43,11 @@ offset_y = 2     # positive = down
 alpha    = 0.55  # multiplied by each component's background opacity
 
 [shell.panel]
-background_blur = true   # request compositor blur behind panels via ext-background-effect-v1
+background_blur       = true   # request compositor blur behind panels via ext-background-effect-v1
+attach_launcher       = false  # attach launcher to the bar when a suitable bar is available
+attach_clipboard      = false  # attach clipboard history to the bar when a suitable bar is available
+attach_control_center = true   # attach Control Center to the bar when a suitable bar is available
+attach_wallpaper      = true   # attach wallpaper picker to the bar when a suitable bar is available
 
 [shell.screen_corners]
 enabled = false    # overlay black rounded corners on each screen
@@ -67,6 +71,7 @@ Notes:
 - `shell.animation.enabled` disables all animated transitions globally. `speed` scales durations globally.
 - `shell.shadow` defines the shared shadow metrics for shell surfaces. Components such as bars and the dock only opt in/out with `shadow = true|false`; they do not define their own blur or offset.
 - `shell.panel.background_blur` toggles compositor blur on every shell panel (control center, launcher, clipboard, attached menus, etc.). Inert on compositors that do not implement `ext-background-effect-v1`.
+- `shell.panel.attach_launcher`, `attach_clipboard`, `attach_control_center`, and `attach_wallpaper` control whether those panels attach to the bar when a suitable bar is available. Attachment still requires the host bar to have `attach_panels = true`.
 - `shell.mpris.blacklist` excludes matching MPRIS players from Noctalia media UI and active-player selection. Entries are case-insensitive and match player bus name, identity, desktop entry, or a bus-name substring token (for example `"spotify"`).
 
 ---