refactor(docs): update icons and structure across documentation

- Enhanced navigation structure in zensical.toml for better organization of self-hosting and developer guides. - Updated icons for various documentation pages to improve visual consistency and clarity. - Added specific icons to configuration and management sections in self-hosting documentation for better context. - Improved icon representation in FAQ and support sections to enhance user experience.
allthingslinux · kzndotsh · Jan 25, 2026 · Jan 21, 2026 · Jan 21, 2026 · Jan 21, 2026
commit 06379ebbacd7b28d9f2a54c35946a50506dc8bad
diff --git a/docs/content/changelog/index.md b/docs/content/changelog/index.md
@@ -1,6 +1,6 @@
 ---
 title: Changelog
-icon: lucide/text-quote
+icon: lucide/history
 ---
 
 --8<-- "CHANGELOG.md"
diff --git a/docs/content/developer/best-practices/index.md b/docs/content/developer/best-practices/index.md
@@ -3,7 +3,7 @@ title: Developer Best Practices
 tags:
   - developer-guide
   - best-practices
-icon: lucide/text-quote
+icon: lucide/award
 ---
 
 # Developer Best Practices

diff --git a/docs/content/developer/best-practices/sentry/index.md b/docs/content/developer/best-practices/sentry/index.md
@@ -5,7 +5,7 @@ tags:
   - developer-guide
   - best-practices
   - sentry
-icon: lucide/text-quote
+icon: lucide/shield-alert
 ---
 
 # Sentry Integration

diff --git a/docs/content/developer/best-practices/testing/index.md b/docs/content/developer/best-practices/testing/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - best-practices
   - testing
-icon: lucide/text-quote
+icon: lucide/flask-conical
 ---
 
 # Testing

diff --git a/docs/content/developer/concepts/core/index.md b/docs/content/developer/concepts/core/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - core
-icon: lucide/text-quote
+icon: lucide/cpu
 ---
 
 # Core Concepts

diff --git a/docs/content/developer/concepts/database/index.md b/docs/content/developer/concepts/database/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - database
-icon: lucide/text-quote
+icon: lucide/database
 ---
 
 # Database Concepts

diff --git a/docs/content/developer/concepts/handlers/index.md b/docs/content/developer/concepts/handlers/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - handlers
-icon: lucide/text-quote
+icon: lucide/zap
 ---
 
 # Handlers

diff --git a/docs/content/developer/concepts/index.md b/docs/content/developer/concepts/index.md
@@ -3,7 +3,7 @@ title: Developer Concepts
 tags:
   - developer-guide
   - concepts
-icon: lucide/text-quote
+icon: lucide/layers
 ---
 
 # Developer Concepts

diff --git a/docs/content/developer/concepts/services/index.md b/docs/content/developer/concepts/services/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - services
-icon: lucide/text-quote
+icon: lucide/server
 ---
 
 # Services

diff --git a/docs/content/developer/concepts/shared/index.md b/docs/content/developer/concepts/shared/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - shared
-icon: lucide/text-quote
+icon: lucide/share-2
 ---
 
 # Shared

diff --git a/docs/content/developer/concepts/tasks/index.md b/docs/content/developer/concepts/tasks/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - tasks
-icon: lucide/text-quote
+icon: lucide/list-todo
 ---
 
 # Tasks

diff --git a/docs/content/developer/concepts/ui/index.md b/docs/content/developer/concepts/ui/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - ui
-icon: lucide/text-quote
+icon: lucide/layout
 ---
 
 # UI Concepts

diff --git a/docs/content/developer/concepts/wrappers/index.md b/docs/content/developer/concepts/wrappers/index.md
@@ -4,7 +4,7 @@ tags:
   - developer-guide
   - concepts
   - wrappers
-icon: lucide/text-quote
+icon: lucide/package
 ---
 
 # Wrappers

diff --git a/docs/content/developer/guides/index.md b/docs/content/developer/guides/index.md
@@ -3,7 +3,7 @@ title: Developer Guides
 tags:
   - developer-guide
   - guides
-icon: lucide/text-quote
+icon: lucide/book-open
 ---
 
 # Developer Guides

diff --git a/docs/content/developer/index.md b/docs/content/developer/index.md
@@ -3,7 +3,7 @@ title: Developer Guide
 description: Index of developer documentation—contributing, tutorials, concepts, best practices, and reference.
 tags:
   - developer-guide
-icon: lucide/text-quote
+icon: lucide/code-2
 ---
 
 # Developer Guide

diff --git a/docs/content/developer/tutorials/index.md b/docs/content/developer/tutorials/index.md
@@ -3,7 +3,7 @@ title: Developer Tutorials
 tags:
   - developer-guide
   - tutorials
-icon: lucide/text-quote
+icon: lucide/graduation-cap
 ---
 
 # Developer Tutorials

diff --git a/docs/content/faq/developers.md b/docs/content/faq/developers.md
@@ -2,7 +2,7 @@
 title: For Developers
 description: Frequently asked questions for Tux developers.
 parent: FAQ
-icon: material/help-circle-outline
+icon: lucide/code-2
 ---
 
 # For Developers

diff --git a/docs/content/faq/general.md b/docs/content/faq/general.md
@@ -2,7 +2,7 @@
 title: General
 description: General frequently asked questions about Tux.
 parent: FAQ
-icon: material/help-circle-outline
+icon: lucide/info
 ---
 
 # General

diff --git a/docs/content/faq/index.md b/docs/content/faq/index.md
@@ -3,7 +3,7 @@ title: FAQ
 description: Frequently asked questions about Tux.
 hide:
   - toc
-icon: lucide/text-quote
+icon: lucide/circle-help
 ---
 
 # Frequently Asked Questions

diff --git a/docs/content/faq/other.md b/docs/content/faq/other.md
@@ -2,7 +2,7 @@
 title: Other
 description: Other frequently asked questions about Tux.
 parent: FAQ
-icon: material/help-circle-outline
+icon: lucide/circle-help
 ---
 
 # Other

diff --git a/docs/content/faq/self-hosters.md b/docs/content/faq/self-hosters.md
@@ -2,7 +2,7 @@
 title: For Self-Hosters
 description: Frequently asked questions for self-hosting Tux.
 parent: FAQ
-icon: material/help-circle-outline
+icon: lucide/server
 ---
 
 # For Self-Hosters

diff --git a/docs/content/faq/users.md b/docs/content/faq/users.md
@@ -2,7 +2,7 @@
 title: For Users
 description: Frequently asked questions for Tux users.
 parent: FAQ
-icon: material/help-circle-outline
+icon: lucide/users
 ---
 
 # For Users

diff --git a/docs/content/reference/coverage.md b/docs/content/reference/coverage.md
@@ -8,6 +8,7 @@ tags:
   - codecov
   - pytest
   - coverage
+icon: lucide/chart-bar
 ---
 
 # Coverage
diff --git a/docs/content/reference/docker-production.md b/docs/content/reference/docker-production.md
@@ -4,6 +4,7 @@ tags:
   - reference
   - docker
   - production
+icon: lucide/container
 ---
 
 # Docker Production Deployment

diff --git a/docs/content/reference/docs/index.md b/docs/content/reference/docs/index.md
@@ -5,7 +5,7 @@ tags:
   - reference
   - docs
   - documentation
-icon: notepad-text-dashed
+icon: lucide/notepad-text-dashed
 ---
 
 # Documentation

diff --git a/docs/content/reference/docs/templates/command-group-template.md b/docs/content/reference/docs/templates/command-group-template.md
@@ -6,6 +6,7 @@ tags:
   - commands
   - command-groups
   - COMMAND_GROUP_TAG
+icon: lucide/folder-tree
 ---
 
 # {COMMAND_GROUP_NAME}

diff --git a/docs/content/reference/docs/templates/command-template.md b/docs/content/reference/docs/templates/command-template.md
@@ -5,6 +5,7 @@ tags:
   - user-guide
   - commands
   - COMMAND_TAG
+icon: lucide/terminal
 ---
 
 # {COMMAND_NAME}

diff --git a/docs/content/reference/docs/templates/feature-template.md b/docs/content/reference/docs/templates/feature-template.md
@@ -5,6 +5,7 @@ tags:
   - user-guide
   - features
   - FEATURE_TAG
+icon: lucide/sparkles
 ---
 
 # FEATURE_NAME

diff --git a/docs/content/reference/docs/templates/index.md b/docs/content/reference/docs/templates/index.md
@@ -5,6 +5,7 @@ tags:
   - documentation
   - templates
   - developer
+icon: lucide/layout-template
 ---
 
 # Documentation Templates

diff --git a/docs/content/reference/docs/templates/module-template.md b/docs/content/reference/docs/templates/module-template.md
@@ -5,6 +5,7 @@ tags:
   - user-guide
   - modules
   - MODULE_TAG
+icon: lucide/component
 ---
 
 # {MODULE_NAME}

diff --git a/docs/content/reference/env.md b/docs/content/reference/env.md
@@ -10,6 +10,7 @@ tags:
   - pydantic-settings
   - dotenv
   - env-variables
+icon: lucide/variable
 ---
 <!-- region:config -->
 # Environment Variables

diff --git a/docs/content/reference/index.md b/docs/content/reference/index.md
@@ -1,5 +1,6 @@
 ---
 title: Reference
+icon: lucide/book-open
 ---
 
 # Reference

diff --git a/docs/content/reference/listings.md b/docs/content/reference/listings.md
@@ -5,6 +5,7 @@ hide:
 tags:
   - reference
   - code-snippets
+icon: lucide/list-ordered
 ---
 ---
 

diff --git a/docs/content/reference/renovate.md b/docs/content/reference/renovate.md
@@ -4,6 +4,7 @@ tags:
   - renovate
   - dependencies
   - ci-cd
+icon: lucide/refresh-cw
 ---
 
 # Renovate Configuration

diff --git a/docs/content/reference/sbom.md b/docs/content/reference/sbom.md
@@ -6,6 +6,7 @@ tags:
   - reference
   - sbom
   - dependencies
+icon: lucide/package
 ---
 ---
 

diff --git a/docs/content/reference/src/tux/index.md b/docs/content/reference/src/tux/index.md
@@ -1,6 +1,6 @@
 ---
 title: API Reference
-icon: material/code-tags
+icon: lucide/code-2
 tags:
   - reference
   - api

diff --git a/docs/content/reference/style-guide.md b/docs/content/reference/style-guide.md
@@ -4,6 +4,7 @@ tags:
   - style-guide
   - docs
   - css
+icon: lucide/type
 ---
 
 # Style Guide

diff --git a/docs/content/reference/versioning.md b/docs/content/reference/versioning.md
@@ -6,6 +6,7 @@ tags:
   - versioning
   - release-process
   - git-tags
+icon: lucide/arrow-up-1-0
 ---
 
 # Versioning System

diff --git a/docs/content/selfhost/config/bot-token.md b/docs/content/selfhost/config/bot-token.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - configuration
   - bot-token
+icon: lucide/key-round
 ---
 
 # Bot Token Configuration

diff --git a/docs/content/selfhost/config/database.md b/docs/content/selfhost/config/database.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - configuration
   - database
+icon: lucide/database
 ---
 
 # Database Configuration

diff --git a/docs/content/selfhost/config/environment.md b/docs/content/selfhost/config/environment.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - configuration
   - environment
+icon: lucide/variable
 ---
 
 # Environment Configuration

diff --git a/docs/content/selfhost/config/index.md b/docs/content/selfhost/config/index.md
@@ -3,6 +3,7 @@ title: Self-Host Configuration
 tags:
   - selfhost
   - configuration
+icon: lucide/cog
 ---
 
 # Self-Host Configuration

diff --git a/docs/content/selfhost/index.md b/docs/content/selfhost/index.md
@@ -2,7 +2,7 @@
 title: Self-Hoster Guide
 tags:
   - selfhost
-icon: material/server-outline
+icon: lucide/server
 ---
 
 # Self-Hoster Guide

diff --git a/docs/content/selfhost/install/baremetal.md b/docs/content/selfhost/install/baremetal.md
@@ -6,6 +6,7 @@ tags:
   - baremetal
   - systemd
   - postgresql
+icon: lucide/hard-drive
 ---
 
 # Bare Metal Installation

diff --git a/docs/content/selfhost/install/docker.md b/docs/content/selfhost/install/docker.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - installation
   - docker
+icon: lucide/container
 ---
 
 # Docker Installation

diff --git a/docs/content/selfhost/install/first-run.md b/docs/content/selfhost/install/first-run.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - installation
   - setup
+icon: lucide/rocket
 ---
 
 # First Run Instructions

diff --git a/docs/content/selfhost/manage/database.md b/docs/content/selfhost/manage/database.md
@@ -4,6 +4,7 @@ tags:
   - selfhost
   - operations
   - database
+icon: lucide/database
 ---
 
 # Database Management
-Original file line number
+Diff line change
@@ Expand Up / @@ -5,6 +5,7 @@ hide: @@
     tags:
       - reference
       - code-snippets
+    icon: lucide/list-ordered
     ---
     ---
@@ Expand Down @@