update changelog and freeze website docs version for 0.9.0

Author: github-actions[bot]

CHANGELOG.md

@@ -5,7 +5,7 @@ homepage = "https://malpenzibo.github.io/ashell/"
 repository = "https://github.com/MalpenZibo/ashell"
 authors = ["Simone Camito (Zibo)"]
 license = "GPL-3.0-or-later"
-version = "0.8.0"
+version = "0.9.0"
 edition = "2024"
 rust-version = "1.89"
 

Cargo.lock

@@ -0,0 +1 @@
+position: 3

Cargo.toml

@@ -0,0 +1 @@
+position: 3

website/versioned_docs/version-0.9.0/configuration/_category_.yml

@@ -0,0 +1,93 @@
+---
+sidebar_position: 1
+---
+
+# General
+
+These are all the appearance options not related to the color palette.
+
+## Font
+
+You can change the font used by setting the `font_name` field. This configuration
+is optional—if not set, the `iced` library will use the default font.
+
+```toml
+[appearance]
+font_name = "Comic Sans MS"
+```
+
+:::warning
+
+Changing the font requires killing and restarting ashell process. The font configuration does not support hot-reloading
+
+:::
+
+## Scaling Factor
+
+You can change the scaling factor of the status bar using the `scale_factor` field.
+
+The value should be a float greater than `0.0` and less than or equal to `2.0`.
+The default value is `1.0`.
+
+```toml
+[appearance]
+scale_factor = 1.5
+```
+
+## Status Bar Style
+
+You can change the style of the status bar using the `style` field.
+
+You can choose between:
+
+- `Islands`: This is the default style. Each module or module group is displayed
+  in a rounded rectangle using the background color.
+- `Solid`: The status bar has a solid background color.
+- `Gradient`: The status bar has a gradient background color.
+
+### Example
+
+```toml
+[appearance]
+style = "Gradient"
+```
+
+## Opacity
+
+You can change the opacity of the status bar components using the `opacity` field.
+
+The value should be a float between `0.0` and `1.0`, where `0.0` is fully transparent.
+The default value is `1.0`.
+
+It's also possible to define the opacity of status bar menus and whether they should
+include a backdrop effect.
+
+The `backdrop` effect adds a blur/transparent background to menus, making them appear
+semi-transparent over the content behind them. The value should be a float between `0.0`
+and `1.0`, where `0.0` disables the effect and `1.0` applies maximum blur.
+
+**Default values:**
+
+- `opacity`: `1.0` (fully opaque)
+- `menu.opacity`: `1.0` (fully opaque)
+- `menu.backdrop`: `0.0` (disabled)
+
+## Examples
+
+Setting the opacity of the status bar components:
+
+```toml
+[appearance]
+opacity = 0.8
+```
+
+Also setting the opacity of the status bar menus and adding a backdrop effect:
+
+```toml
+[appearance]
+opacity = 0.8
+
+[appearance.menu]
+opacity = 0.7
+backdrop = 0.3
+```

website/versioned_docs/version-0.9.0/configuration/appearance/_category_.yml

@@ -0,0 +1,17 @@
+# 🎨 Appearance
+
+With these configurations, you can change the appearance of ashell.
+
+It's possible to modify the color palette and other general visual aspects.
+
+All of these configurations should be placed in the `appearance` section  
+of the configuration file.
+
+You can customize things like:
+
+- The color palette
+- The font used
+- The scaling factor of the status bar
+- The style of the status bar
+- The opacity of the status bar components
+- The opacity of the status bar menus

website/versioned_docs/version-0.9.0/configuration/appearance/general.md

@@ -0,0 +1,91 @@
+---
+sidebar_position: 2
+---
+
+# Palette
+
+With these configuration options, you can customize
+the color palette of your status bar.
+
+## Color Syntax
+
+Each color can be specified as a simple hex color or as an object with variants.
+
+### Simple Syntax
+
+```toml
+primary_color = "#7aa2f7"
+```
+
+### Advanced Syntax
+
+```toml
+[appearance.primary_color]
+base = "#7aa2f7"
+strong = "#8aacff"
+weak = "#6988e6"
+text = "#1a1b26"
+```
+
+All fields except `base` are optional. If not provided, they are
+auto-generated from the base color:
+
+- **`weak`**: The base color faded toward the background. Used for subtle,
+  de-emphasized states (e.g. hover backgrounds, inactive elements).
+- **`strong`**: The base color pushed away from the background for more
+  contrast. Used for emphasized, active states.
+- **`text`**: The text color to use on top of this color. If not provided,
+  the default text color is used (with automatic contrast adjustment).
+
+## Palette Colors
+
+| Color | Description |
+|-------|-------------|
+| `background_color` | Background color for all status bar components |
+| `primary_color` | Accent color for interactive elements (buttons, slider handles, active states) |
+| `success_color` | Positive feedback indicators (e.g. connected, active) |
+| `warning_color` | Cautionary indicators (e.g. alerts that need attention) |
+| `danger_color` | Error or destructive state indicators |
+| `text_color` | Default text color |
+
+### Background Color
+
+The background color supports additional granularity. Beyond `base`, `weak`,
+`strong`, and `text`, you can also specify intermediate levels:
+
+```toml
+[appearance.background_color]
+base = "#1e1e2e"
+weakest = "#1a1a28"
+weaker = "#1c1c2c"
+weak = "#313244"
+neutral = "#3a3a50"
+strong = "#45475a"
+stronger = "#505268"
+strongest = "#5a5c76"
+text = "#cdd6f4"
+```
+
+All levels are optional. When omitted, they are auto-generated as
+gradual steps between the base color and the text color, providing
+a range of surface tones from subtle to prominent.
+
+## Workspace Colors
+
+You can specify which color to use for workspace indicators based on
+the monitor to which a workspace is attached.
+
+For example, if workspace 1 is attached to `monitorA`, the first
+color will be used; if workspace 2 is attached to `monitorB`,
+the second color will be used, and so on.
+
+Use the `workspace_colors` field for regular workspaces, and
+`special_workspace_colors` for special workspaces.
+
+If `special_workspace_colors` is not defined, `workspace_colors` will be used.
+If neither `workspace_colors` is defined nor a color exists
+for a given monitor, the `primary_color` will be used.
+
+## Complete Examples
+
+For complete theme examples with full palette configurations, see the [Theme documentation](./theme.md).

website/versioned_docs/version-0.9.0/configuration/appearance/index.md

@@ -0,0 +1,66 @@
+---
+sidebar_position: 3
+---
+
+# Theme
+
+## Catppuccin Mocha
+
+```toml
+[appearance]
+
+success_color = "#a6e3a1"
+warning_color = "#f9e2af"
+danger_color = "#f38ba8"
+text_color = "#cdd6f4"
+
+workspace_colors = [ "#fab387", "#b4befe", "#cba6f7" ]
+
+[appearance.primary_color]
+base = "#fab387"
+text = "#1e1e2e"
+
+[appearance.background_color]
+base = "#1e1e2e"
+weak = "#313244"
+strong = "#45475a"
+```
+
+## Tokyo Night - night
+
+```toml
+[appearance]
+
+primary_color = "#7aa2f7"
+success_color = "#9ece6a"
+warning_color = "#e0af68"
+danger_color = "#f7768e"
+text_color = "#a9b1d6"
+
+workspace_colors = [ "#7aa2f7", "#9ece6a" ]
+
+[appearance.background_color]
+base = "#1a1b26"
+weak = "#24273a"
+strong = "#414868"
+```
+
+## Nord
+
+```toml
+[appearance]
+success_color = "#a3be8c"
+warning_color = "#ebcb8b"
+danger_color = "#bf616a"
+text_color = "#eceff4"
+workspace_colors = [ "#88c0d0", "#81a1c1", "#5e81ac" ]
+
+[appearance.primary_color]
+base = "#88c0d0"
+text = "#242933"
+
+[appearance.background_color]
+base = "#3b4252"
+weak = "#434c5e"
+strong = "#4c566a"
+```