docs: add custom color info

docs/library/tag.md

@@ -68,11 +68,15 @@ Component tags will be built from a composition-based, or "HAS" type relationshi
 
 ### Color
 
-Tags use a default uncolored appearance by default, however can take on a number of built-in and user-created\* colors and color palettes! Tag color palettes can be based on a single color value (see: TagStudio Standard, TagStudio Shades, TagStudio Pastels) or use an optional secondary color to override the border and text colors (see: TagStudio Neon).
+Tags use a default uncolored appearance by default, however can take on a number of built-in and user-created colors and color palettes! Tag color palettes can be based on a single color value (see: TagStudio Standard, TagStudio Shades, TagStudio Pastels) or use an optional secondary color use for the text and optionally the tag border (e.g. TagStudio Neon).
 
 ![Tag Color Selection](../assets/tag_color_selection.png)
 
-\*_Coming in the full version 9.5.0 release_
+#### User-Created Colors
+
+Custom palettes and colors can be created via the [Tag Color Manager](./tag_color.md). These colors will display alongside the built-in colors inside the tag selection window and are separated by their namespace names. Colors which use the secondary color for the tag border will be outlined in that color, otherwise they will only display the secondary color on the bottom of the swatch to indicate at a glance that the text colors are different.
+
+![Custom Tag Color Selection](../assets/custom_tag_color_selection.png)
 
 ### Icon
 

docs/library/tag_color.md

@@ -0,0 +1,71 @@
+# Tag Colors
+
+TagStudio features a variety of built-in tag colors, alongside the ability for users to create their own custom tag color palettes.
+
+## Tag Color Manager
+
+The Tag Color Manager is where you can create and manage your custom tag colors and associated namespaces. To open the Tag Color Manager, go to "File -> Manage Tag Colors" option in the menu bar.
+
+![Tag Color Manager](../assets/tag_color_manager.png)
+
+## Creating a Namespace
+
+TagStudio uses namespaces to group colors into palettes. Namespaces are a way for you to use the same color name across multiple palettes without having to worry about [name collision](https://en.wikipedia.org/wiki/Name_collision) with other palettes. This is especially useful when sharing your color palettes with others!\*
+
+_\* Color pack sharing coming in a future update_
+
+To create your first namespace, either click the "New Namespace" button or the large button prompt underneath the built-in colors.
+
+![Create Namespace](../assets/create_namespace.png)
+
+### Name
+
+The display name of the namespace, used for presentation.
+
+### ID Slug
+
+An internal ID for the namespace which is automatically derived from the namespace name.
+
+Namespaces beginning with "tagstudio" are reserved by TagStudio and will automatically have their text changed.
+
+<!-- prettier-ignore -->
+!!! note
+    It's currently not possible to manually edit the Namespace ID Slug. This will be possible once sharable color packs are added.
+
+## Creating a Color
+
+Once you've created your first namespace, click the "+" button inside the namespace section to create a color. To edit a color that you've previously created, either click on the color name or right click and select "Edit Color" from the context menu.
+
+![Create Color (Primary Color)](../assets/custom_color_primary_only.png)
+
+### Name
+
+The display name for the color, used for presentation. You may occasionally see the color name followed by the [namespace name](#name) in parentheses to disambiguate it from other colors with the same name.
+
+### ID Slug
+
+Similar to [Namespace ID Slugs](#id-slug), the ID Slug is used as an internal ID and is automatically derived from the tag color name.
+
+<!-- prettier-ignore -->
+!!! note
+    It's currently not possible to manually edit the Color ID Slug. This will be possible once sharable color packs are added.
+
+### Primary Color
+
+The primary color is used as the main tag color and by default is used as the background color with the text and border colors being derived from this color.
+
+### Secondary Color
+
+By default, the secondary color is only used as an optional override for the tag text color. This color can be cleared by clicking the adjacent "Reset" button.
+
+![Create Color (Secondary Color)](../assets/custom_color_no_border.png)
+
+The secondary color can also be used as the tag border color by checking the "Use Secondary Color for Border" box.
+
+![Create Color (Use Secondary for Border)](../assets/custom_color_border.png)
+
+## Using Colors
+
+When editing a tag, click the tag color button to bring up the tag color selection panel. From here you can choose any built-in TagStudio color as well as any of your custom colors.
+
+![Tag Color Selection](../assets/tag_color_selection.png)