docs: a few minor updates to the docs

Author: imp-dance

docs/docs/customization.md

@@ -4,9 +4,36 @@ sidebar_position: 6
 
 # Customization
 
+## Hard-coding through props
+
 You can pass a couple of options directly to the `RadixOS` component to customize the Radix theme:
 
 - `accentColor`: The preferred accent color of the Radix theme
 - `radius`: The preferred radius of the Radix theme
+- `panelBackground`: `"solid" | "translucent"` Determines if translucency is activated
+- `theme`: (`light` | `dark`) Determines if dark-mode is enabled
+
+## Programatically setting settings
+
+You can utilize the hook `useSettingsStore` to change the customization settings from within an application running in the system.
+
+```ts
+type SettingsStore = {
+  theme: "light" | "dark";
+  toggleTheme: () => void;
+  panelBackground: "solid" | "translucent";
+  togglePanelBackground: () => void;
+  bg: string;
+  setBg: (bg: string) => void;
+  radius: Radius;
+  setRadius: (value: Radius) => void;
+  accentColor: AccentColor;
+  setAccentColor: (value: AccentColor) => void;
+  overrides: (keyof SettingsStore)[];
+  setOverrides: (overrides: (keyof SettingsStore)[]) => void;
+}
+```
 
-Beyond that, the settings app (and hook) allows you to set if _translucency_ is enabled, the preferred desktop background and dark mode.
+:::warning
+Passing props to `RadixOS` overrides the dynamic values set by `useSettingsStore`, unless `overrides` are manually set to an empty array.
+:::

docs/docs/index.md

@@ -6,8 +6,11 @@ sidebar_position: 1
 
 Radix OS is an operating system simulated on the web, with a modular file system that can be swapped out with any async source, able to run your own custom built applications. Designed to be flexible and easily extendable so it can fit your needs.
 
+
 [![Preview](/sh.jpg)](https://imp-dance.github.io/radix-os/)
 
+- [Open live demo](https://imp-dance.github.io/radix-os/)
+
 :::tip So what it, really?
 
 A React component, coupled with a few helper functions and hooks - published to NPM. Together, this package lets you create an OS-like environment, and inject custom applications of your own.