labbdocs 0.2.0__tar.gz → 0.3.1__tar.gz

{labbdocs-0.2.0 → labbdocs-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labbdocs
-Version: 0.2.0
+Version: 0.3.1
 Summary: Documentation for the labb project
 License: MIT
 License-File: LICENSE

{labbdocs-0.2.0/labbdocs/content/ui → labbdocs-0.3.1/labbdocs/content/guide}/1_getting_started/2_installation.md

@@ -3,34 +3,59 @@ title: Installation
 description: How to install and set up labb in your Django project
 ---
 
-<c-lbdocs.labbstart_info class="my-6" />
+{% load docs_tags %}
 
-## Prerequisites
+## New Project (Recommended)
 
-Before installing labb, make sure you have:
+The fastest way to get started is with **labbstart**, which scaffolds a new Django project with labb pre-configured.
 
-- Django 4.2 or higher
-- Python 3.8 or higher
+```bash
+pip install labbstart
+labbstart new
+```
+
+This interactively prompts you for project name, Django version, package manager, and starter kit. You can also pass flags directly:
+
+```bash
+labbstart new myproject --django-version 5 --package-manager poetry --kit welcome --app-name starter
+```
+
+Once created, start two terminals:
+
+```bash
+# Terminal 1 — CSS watcher
+cd your-project-name && labb dev
+
+# Terminal 2 — Django server
+cd your-project-name && python manage.py runserver
+```
+
+Open [http://localhost:8000](http://localhost:8000) and you're ready to build.
+
+---
+
+## Existing Project
 
-## Install labb
+### Prerequisites
 
-### Using pip
+- Python 3.8+
+- Django 4.2+
+
+### Step 1: Install labb
 
 ```bash
 pip install labbui
 ```
 
-### Using Poetry
+Or with Poetry:
 
 ```bash
 poetry add labbui
 ```
 
-## Add to Django Settings
-
-Add `labb` to your `INSTALLED_APPS` in your Django settings:
+### Step 2: Add to Django Settings
 
-### Automatic configuration:
+Add `labb` to your `INSTALLED_APPS`:
 
 <c-lbdocs.codeblock.title title="settings.py">
 ```python
@@ -42,11 +67,10 @@ INSTALLED_APPS = [
 ```
 </c-lbdocs.codeblock.title>
 
-This will attempt to automatically handle the settings.py by adding the required loader and templatetags.
+This automatically configures the required template loader and templatetags.
 
-### Custom configuration
-
-If your project requires any non-default loaders or you do not wish Cotton to manage your settings, you should instead provide `django_cotton.apps.SimpleAppConfig` in your INSTALLED_APPS:
+<c-lb.collapse title="Custom configuration" class="my-4" style="arrow">
+If your project uses non-default loaders or you don't want Cotton to manage your settings, use `django_cotton.apps.SimpleAppConfig` instead:
 
 <c-lbdocs.codeblock.title title="settings.py">
 ```python
@@ -86,54 +110,20 @@ TEMPLATES = [
 ]
 ```
 </c-lbdocs.codeblock.title>
+</c-lb.collapse>
 
-## Initialize labb Project
-
-After adding labb to your Django settings, you need to initialize and set up labb in your project:
-
-### Step 1: Initialize Project
-
-Initialize labb project with configuration and project structure:
-
-```bash
-labb init
-```
-
-For quick setup with defaults:
+### Step 3: Initialize and Set Up
 
 ```bash
 labb init --defaults
-```
-
-**Init Options:**
-
-```bash
-# Force overwrite existing files created by labb init
-labb init --force
-```
-### Step 2: Install Dependencies
-
-Install the required Node.js dependencies:
-
-```bash
 labb setup
 ```
 
-**Setup Options:**
+`labb init` creates the project configuration and structure. `labb setup` installs the required Node.js dependencies.
 
-```bash
-# Install dependencies automatically
-labb setup --install-deps
-
-# Skip dependency installation
-labb setup --no-install-deps
-```
+### Step 4: Add Dependencies to Your Template
 
-## Add Dependencies to Your Template
-
-<c-lb.alert variant="info" style="soft" icon="rmx.information" iconFill class="mb-4">
-<span>Add `<c-lb.m.dependencies />` to your main HTML template's `<head>` section. This includes the required CSS and JavaScript for labb components to work properly.</span>
-</c-lb.alert>
+Add `<c-lb.m.dependencies />` to your base template's `<head>` section:
 
 <c-lbdocs.codeblock.title title="templates/base.html">
 {% verbatim %}
@@ -146,8 +136,6 @@ labb setup --no-install-deps
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>My labb App</title>
-
-    <!-- Required: Add labb dependencies -->
     <c-lb.m.dependencies setThemeEndpoint="{% url 'set_theme' %}" />
 </head>
 <body>
@@ -162,43 +150,46 @@ labb setup --no-install-deps
 <span>Without `<c-lb.m.dependencies />`, components will not have the correct styling and interactive features may not work.</span>
 </c-lb.alert>
 
-## Basic Usage
-
-Once installed and setup, you can start using components in your templates.
+### Step 5: Start Developing
 
-First, start the labb development watcher to monitor changes and build CSS:
+Start two terminals:
 
 ```bash
+# Terminal 1 — CSS watcher
 labb dev
-```
 
-This will start both CSS building and template scanning in watch mode. Keep this running while you develop.
-
-Next, in a **separate terminal**, start your Django development server:
-
-```bash
+# Terminal 2 — Django server
 python manage.py runserver
 ```
 
-Now you can create templates with labb components:
+---
+
+## Basic Usage
+
+Use labb components in your templates with HTML-like syntax:
 
 <c-lbdocs.codeblock.title title="templates/example.html">
 {% verbatim %}
 ```html
-<!-- Basic button -->
 <c-lb.button variant="primary">Click me</c-lb.button>
 
-<!-- Card component -->
 <c-lb.card>
     <c-lb.card.body>
-    <c-lb.card.title>Card Title</c-lb.card.title>
-    <p>Card content goes here</p>
+        <c-lb.card.title>Card Title</c-lb.card.title>
+        <p>Card content goes here</p>
     </c-lb.card.body>
 </c-lb.card>
+
+<c-lb.alert variant="success">Success message!</c-lb.alert>
 ```
 {% endverbatim %}
 </c-lbdocs.codeblock.title>
 
+Browse <a href="{% doc_url '1_actions/button.md' 'ui' %}">component documentation</a> for all available components.
+
 ## Next Steps
 
-Head to the <a href="{% doc_url '1_getting_started/3_quick_start.md' 'ui' %}">Quick Start guide</a> for a concise step-by-step overview of using labb.
+- <a href="{% doc_url '2_concepts/1_theming.md' 'guide' %}">Theming</a> — Customize colors and themes
+- <a href="{% doc_url '2_concepts/2_building_css.md' 'guide' %}">Building CSS</a> — CSS build process and production builds
+- <a href="{% doc_url '3_references/0_labb_cli.md' 'guide' %}">CLI Reference</a> — Component inspection, icon search, and more
+- <a href="{% doc_url '1_getting_started/1_introduction.md' 'icons' %}">Icons</a> — Install labbicons for 2,800+ Remix icons

labbdocs-0.3.1/labbdocs/content/guide/1_getting_started/3_changelog.md

@@ -0,0 +1,74 @@
+---
+title: Changelog
+description: Release history and version notes for labb
+---
+
+{% load docs_tags %}
+
+
+## 0.3.0 <c-lb.badge size="sm">latest</c-lb.badge>
+
+**Mar 08, 2026**
+
+### Features
+
+- Full daisyUI components support 🎉
+- Restructure of docs for better readability
+- Introduction of props modifiers for icon props in supported components. See components like button, badge, etc.
+
+---
+
+## 0.2.0
+
+**Feb 09, 2026**
+
+### Features
+- **labbstart** — Starter kit scaffolding tool ([#20](https://github.com/labbhq/labb/issues/20))
+- **Breadcrumbs** — New breadcrumbs component ([#25](https://github.com/labbhq/labb/issues/25))
+- **Carousel** — New carousel component ([#27](https://github.com/labbhq/labb/issues/27))
+
+### Maintenance
+- Enhanced README ([#22](https://github.com/labbhq/labb/issues/22))
+
+---
+
+## 0.1.1
+
+**Jan 03, 2026**
+
+### Maintenance
+- Documentation site cleanup ([#14](https://github.com/labbhq/labb/issues/14))
+
+---
+
+## 0.1.0
+
+**Dec 30, 2025**
+
+Initial stable release.
+
+---
+
+## 0.0.2
+
+**Dec 30, 2025**
+
+### Maintenance
+- Blog post support for docs ([#2](https://github.com/labbhq/labb/issues/2))
+- Community menu ([#4](https://github.com/labbhq/labb/issues/4))
+
+---
+
+## 0.0.1a2
+
+**Oct 29, 2025**
+
+Alpha pre-release with early feature and bug fix work.
+
+---
+
+## 0.0.1a
+
+**Oct 26, 2025**
+
+First alpha pre-release.

labbdocs-0.3.1/labbdocs/content/guide/1_getting_started/4_roadmap.md

@@ -0,0 +1,97 @@
+---
+title: Roadmap
+description: Planned features and future direction for labb
+doc_show_toc: false
+---
+
+## Roadmap to v1.0.0
+
+
+This roadmap outlines the planned direction for labb. Priorities may shift based on community feedback. Have a feature request? Open a discussion on [GitHub](https://github.com/labbhq/labb/discussions).
+
+
+<div class="not-prose">
+<c-lb.timeline direction="vertical" snap compact>
+    <c-lb.timeline.item first variant="success" icon="rmx.checkbox-circle">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">v0.3.0</span>
+                <p class="text-sm">Full daisyUI components support</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item variant="warning" icon="rmx.loader-4">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">v0.4.0</span>
+                <p class="text-sm">AlpineJS integration</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">IDE extensions</span>
+                <p class="text-sm">Autocomplete and inline documentation</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">Charts</span>
+                <p class="text-sm">Interactive charts and data visualization</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+    <c-slot name="endSlot">
+        <c-lb.timeline.end box class="my-6">
+            <span class="font-bold">labbwire</span>
+            <p class="text-sm">HTML over the wire, the Django (cotton) way</p>
+        </c-lb.timeline.end>
+    </c-slot>
+    </c-lb.timeline.item>
+     <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">Playground</span>
+                <p class="text-sm">Testing and experimenting with components</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">Blocks and templates</span>
+                <p class="text-sm">Pre-built page sections and full page layouts</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">More icon packs</span>
+                <p class="text-sm">Additional icon libraries beyond Remix Icons</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+    <c-lb.timeline.item icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">Advanced components</span>
+                <p class="text-sm">Date pickers, calendars, rich text editors, file upload, forms</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+
+    <c-lb.timeline.item last icon="rmx.time">
+        <c-slot name="endSlot">
+            <c-lb.timeline.end box class="my-6">
+                <span class="font-bold">Starter kits</span>
+                <p class="text-sm">Pre-built project templates for common use cases</p>
+            </c-lb.timeline.end>
+        </c-slot>
+    </c-lb.timeline.item>
+</c-lb.timeline>
+</div>

labbdocs-0.3.1/labbdocs/content/guide/1_getting_started/5_credits.md

@@ -0,0 +1,38 @@
+---
+title: Credits
+description: The projects and people that make labb possible
+---
+
+{% load docs_tags %}
+
+labb is built on the shoulders of excellent open source projects.
+
+## Core Dependencies
+
+- **[Django](https://www.djangoproject.com/)** — The web framework that powers everything
+- **[Django Cotton](https://django-cotton.com/)** — Component syntax and template loader that makes `<c-lb.*>` possible
+- **[daisyUI](https://daisyui.com/)** — Component classes and theming for Tailwind CSS
+- **[Tailwind CSS](https://tailwindcss.com/)** — Utility-first CSS framework
+
+## CLI and Tooling
+
+- **[Typer](https://typer.tiangolo.com/)** — CLI framework powering the `labb` command
+- **[Rich](https://rich.readthedocs.io/)** — Terminal formatting and output
+
+## Icons
+
+- **[Remix Icon](https://remixicon.com/)** — 2,800+ open source icons included via `labbicons`
+
+
+---
+
+## Similar Projects
+
+- **[shadcn-django](https://shadcn-django.com/)** — shadcn/ui components for Django
+
+---
+
+
+## License
+
+labb is released under the [MIT License](https://github.com/labbhq/labb/blob/main/LICENSE).

labbdocs-0.3.1/labbdocs/content/guide/2_concepts/1_theming.md

@@ -0,0 +1,183 @@
+---
+title: "Theming"
+description: "Customize themes, create custom color schemes, and integrate daisyUI theming with labb components."
+---
+
+{% load docs_tags %}
+
+labb's theming is built on <a href="https://daisyui.com/docs/themes/" target="_blank">daisyUI 5</a>. Themes are defined as CSS variables in `input.css`, applied via template tags, and optionally persisted server-side.
+
+## Setup
+
+Add the `{% verbatim %}{% labb_theme %}{% endverbatim %}` tag to your `<html>` element and register the theme persistence URL:
+
+<c-lbdocs.codeblock.title title="templates/base.html">
+{% verbatim %}
+```html
+{% load lb_tags %}
+
+<!DOCTYPE html>
+<html lang="en" {% labb_theme %}>
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>My labb App</title>
+    <c-lb.m.dependencies setThemeEndpoint="{% url 'set_theme' %}" />
+</head>
+<body>
+    {% csrf_token %}
+    <!-- Your content -->
+</body>
+</html>
+```
+{% endverbatim %}
+</c-lbdocs.codeblock.title>
+
+<c-lbdocs.codeblock.title title="urls.py">
+```python
+from django.urls import path
+from labb.shortcuts import set_theme_view
+
+urlpatterns = [
+    # ... your other URLs
+    path('set-theme/', set_theme_view, name='set_theme'),
+]
+```
+</c-lbdocs.codeblock.title>
+
+`{% verbatim %}{% labb_theme %}{% endverbatim %}` outputs `data-theme="theme-name"` on the `<html>` element, reading from the user's session or falling back to `LABB_SETTINGS['DEFAULT_THEME']`. The `{% verbatim %}{% csrf_token %}{% endverbatim %}` is required for the theme persistence POST request.
+
+<c-lb.alert variant="info" style="outline" class="mt-4">
+<span>Use `{% verbatim %}{% labb_theme_val %}{% endverbatim %}` instead if you need the raw theme value for conditional logic (e.g., `{% verbatim %}{% labb_theme_val as current_theme %}{% endverbatim %}`).</span>
+</c-lb.alert>
+
+## Built-in Themes
+
+`labb init` generates an `input.css` with four themes:
+
+- `labb-light` (default) — custom labb light theme
+- `labb-dark` — custom labb dark theme
+- `light` — daisyUI default light
+- `dark` — daisyUI default dark
+
+<c-lbdocs.codeblock.title title="static_src/input.css">
+```css
+@import "tailwindcss";
+@plugin "daisyui" {
+  themes: light, dark;
+}
+
+@plugin "daisyui/theme" {
+  name: "labb-light";
+  default: true;
+  prefersdark: false;
+  color-scheme: light;
+
+  --color-base-100: oklch(100% 0 0);
+  --color-primary: oklch(9% 0.005 247);
+  /* ... */
+}
+
+@plugin "daisyui/theme" {
+  name: "labb-dark";
+  default: false;
+  prefersdark: true;
+  color-scheme: dark;
+  /* ... */
+}
+```
+</c-lbdocs.codeblock.title>
+
+## Custom Themes
+
+Add `@plugin "daisyui/theme"` blocks to `input.css`. Use the <a href="https://daisyui.com/theme-generator/" target="_blank">daisyUI Theme Generator</a> for interactive creation.
+
+<c-lbdocs.codeblock.title title="static_src/input.css">
+```css
+@plugin "daisyui/theme" {
+  name: "my-brand";
+  default: false;
+  color-scheme: light;
+
+  --color-primary: oklch(55% 0.3 240);
+  --color-secondary: oklch(70% 0.25 200);
+  --color-accent: oklch(65% 0.25 160);
+  --color-base-100: oklch(98% 0.02 240);
+  --color-base-content: oklch(20% 0.05 240);
+  --radius-selector: 1rem;
+  --radius-field: 0.25rem;
+  --radius-box: 0.5rem;
+}
+```
+</c-lbdocs.codeblock.title>
+
+See the <a href="https://daisyui.com/docs/themes/" target="_blank">daisyUI themes documentation</a> for all available variables.
+
+## Theme Controllers
+
+Any radio or checkbox component becomes a theme switcher by adding the `theme-controller` class. When server-side persistence is enabled, the choice is automatically sent to the server.
+
+```html
+<!-- Toggle between light and dark -->
+<c-lb.toggle class="theme-controller" value="labb-dark" size="sm" title="Toggle theme" />
+
+<!-- Or use a checkbox -->
+<c-lb.checkbox class="theme-controller" value="labb-dark" title="Dark mode" />
+```
+
+See the <a href="{% doc_url '1_actions/theme-controller.md' 'ui' %}">Theme Controller component documentation</a> for more examples.
+
+## Django Settings
+
+<c-lbdocs.codeblock.title title="settings.py">
+```python
+LABB_SETTINGS = {
+    'DEFAULT_THEME': 'labb-light',  # Fallback when no theme is set
+}
+```
+</c-lbdocs.codeblock.title>
+
+See <a href="{% doc_url '3_references/2_django_settings.md' 'guide' %}">settings reference</a> for all options.
+
+## Advanced Usage
+
+<c-lb.collapse title="Custom theme view" class="my-4" style="arrow">
+If you need custom logic instead of the pre-built `set_theme_view`, use the utility functions directly:
+
+<c-lbdocs.codeblock.title title="views.py">
+```python
+from django.http import JsonResponse
+from django.views.decorators.http import require_http_methods
+from labb.shortcuts import set_labb_theme, get_labb_theme
+
+@require_http_methods(["POST"])
+def set_theme(request):
+    theme = request.POST.get("theme")
+    if not theme:
+        return JsonResponse({"success": False, "error": "Theme parameter is required"}, status=400)
+
+    success = set_labb_theme(request, theme)
+    if success:
+        return JsonResponse({"success": True, "theme": theme})
+    return JsonResponse({"success": False, "error": "Failed to set theme"}, status=500)
+```
+</c-lbdocs.codeblock.title>
+
+**Available functions** (import from `labb.shortcuts`):
+
+- `set_labb_theme(request, theme)` — sets the theme in the session, returns `True`/`False`
+- `get_labb_theme(request)` — retrieves the current theme from the session
+- `set_theme_view` — pre-built view for theme persistence
+</c-lb.collapse>
+
+## Troubleshooting
+
+- **Theme not applying** — Run `labb build` to rebuild CSS, verify theme names match in CSS and HTML
+- **Persistence not working** — Ensure `{% verbatim %}{% csrf_token %}{% endverbatim %}` is in the `<body>` and `setThemeEndpoint` is set on `<c-lb.m.dependencies />`
+- **Styles not updating** — Hard refresh browser, restart `labb dev`
+
+## Resources
+
+- <a href="https://daisyui.com/docs/themes/" target="_blank">daisyUI Themes Documentation</a>
+- <a href="https://daisyui.com/theme-generator/" target="_blank">daisyUI Theme Generator</a>
+- <a href="https://oklch.com/" target="_blank">OKLCH Color Picker</a>

{labbdocs-0.2.0/labbdocs/content/ui/2_references → labbdocs-0.3.1/labbdocs/content/guide/3_references}/0_labb_cli.md

@@ -328,7 +328,7 @@ labb components ex modal basic-modal
 ### `labb icons`
 
 <c-lbdocs.indented_block>
-Search and manage icon packs (requires <a href="{% doc_url '1_getting_started/2_installation.md' 'icons' %}">labbicons package</a> to be installed).
+Search and manage icon packs (requires <a href="{% doc_url '1_getting_started/1_introduction.md' 'icons' %}">labbicons package</a> to be installed).
 
 > *If the `labbicons` package is not installed, the command will show an error with installation instructions.*
 

{labbdocs-0.2.0/labbdocs/content/ui/2_references → labbdocs-0.3.1/labbdocs/content/guide/3_references}/1_config_yaml.md

@@ -29,7 +29,7 @@ css:
 
 ### CSS Build Configuration
 
-Controls how CSS is built using Tailwind CSS 4 when using the <a href="{% doc_url '2_references/0_labb_cli.md' 'ui' %}#labb-build">`labb build`</a> command:
+Controls how CSS is built using Tailwind CSS 4 when using the <a href="{% doc_url '3_references/0_labb_cli.md' 'guide' %}#labb-build">`labb build`</a> command:
 
 ```yaml
 css:
@@ -51,7 +51,7 @@ labb build --no-minify
 
 ### CSS Scan Configuration
 
-Controls how templates are scanned for labb components when using the <a href="{% doc_url '2_references/0_labb_cli.md' 'ui' %}#labb-scan">`labb scan`</a> command:
+Controls how templates are scanned for labb components when using the <a href="{% doc_url '3_references/0_labb_cli.md' 'guide' %}#labb-scan">`labb scan`</a> command:
 
 ```yaml
 css:

{labbdocs-0.2.0/labbdocs/content/ui/2_references → labbdocs-0.3.1/labbdocs/content/guide/3_references}/3_lb_tags.md

@@ -198,4 +198,4 @@ Returns the raw theme value from the user's session or the default theme from Dj
 </c-lbdocs.indented_block>
 
 
-See the [configuration documentation]({% doc_url '2_references/1_config_yaml.md' 'ui' %}) and [Django settings documentation]({% doc_url '2_references/2_django_settings.md' 'ui' %}) for more details about using some of these tags.
+See the [configuration documentation]({% doc_url '3_references/1_config_yaml.md' 'guide' %}) and [Django settings documentation]({% doc_url '3_references/2_django_settings.md' 'guide' %}) for more details about using some of these tags.

{labbdocs-0.2.0/labbdocs/content/ui/2_references → labbdocs-0.3.1/labbdocs/content/guide/3_references}/4_c-lb.m.md

@@ -39,7 +39,7 @@ Includes essential CSS, JavaScript, and styling dependencies for labb components
 **What it includes:**
 
 - **Global CSS**: Automatically includes labb CSS using `lb_css_path` template tag
-- **Theme Controller**: A small piece of JavaScript for handling theme switching with session persistence when the `setThemeEndpoint` parameter is provided. See the [theming documentation]({% doc_url '1_getting_started/4_theming.md' 'ui' %}) for more details.
+- **Theme Controller**: A small piece of JavaScript for handling theme switching with session persistence when the `setThemeEndpoint` parameter is provided. See the [theming documentation]({% doc_url '2_concepts/1_theming.md' 'guide' %}) for more details.
 
 **CSRF Token Requirements:**