labbdocs 0.3.1__tar.gz → 0.4.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labbdocs
-Version: 0.3.1
+Version: 0.4.0
 Summary: Documentation for the labb project
 License: MIT
 License-File: LICENSE
@@ -33,19 +33,19 @@ Description-Content-Type: text/markdown
 
 # labbdocs
 
-The documentation is available online at [https://labb.io/](https://labb.io/).
+**labbdocs** packages the [labb.io](https://labb.io/) documentation as a Django app: UI component reference, guides, icons, and blog — all powered by **labb**, **django-cotton**, **Tailwind CSS**, and **daisyUI 5**.
 
-This documentation is installed as a django app in the django project that powers the [labb.io](https://labb.io) website.
+The public site at [https://labb.io/](https://labb.io/) runs this app alongside the labb marketing pages. Install **labbdocs** in your own Django project if you want to embed or mirror that docs experience.
 
-## Installation
+## Install the labbdocs package
 
 ```bash
 pip install labbdocs
 ```
 
-## Integration with a django site
+## Integrate labbdocs into Django
 
-### 1. Add to INSTALLED_APPS
+### 1. Add labbdocs to INSTALLED_APPS
 
 Add `labbdocs` to your Django project's `INSTALLED_APPS`:
 
@@ -57,9 +57,9 @@ INSTALLED_APPS = [
 ]
 ```
 
-### 2. Configure LABB_DOCS
+### 2. Configure LABB_DOCS in settings
 
-Set up your documentation configuration in your Django settings:
+Set up your documentation configuration in Django settings:
 
 ```python
 # settings.py
@@ -83,7 +83,7 @@ LABB_DOCS = {
 }
 ```
 
-### 3. Include URLs
+### 3. Include labbdocs URLs
 
 Add labbdocs URLs to your main URL configuration:
 
@@ -97,7 +97,7 @@ urlpatterns = [
 ]
 ```
 
-### 4. Build Documentation
+### 4. Build documentation
 
 Use the management command to build your documentation:
 

{labbdocs-0.3.1 → labbdocs-0.4.0}/README.md

@@ -1,18 +1,18 @@
 # labbdocs
 
-The documentation is available online at [https://labb.io/](https://labb.io/).
+**labbdocs** packages the [labb.io](https://labb.io/) documentation as a Django app: UI component reference, guides, icons, and blog — all powered by **labb**, **django-cotton**, **Tailwind CSS**, and **daisyUI 5**.
 
-This documentation is installed as a django app in the django project that powers the [labb.io](https://labb.io) website.
+The public site at [https://labb.io/](https://labb.io/) runs this app alongside the labb marketing pages. Install **labbdocs** in your own Django project if you want to embed or mirror that docs experience.
 
-## Installation
+## Install the labbdocs package
 
 ```bash
 pip install labbdocs
 ```
 
-## Integration with a django site
+## Integrate labbdocs into Django
 
-### 1. Add to INSTALLED_APPS
+### 1. Add labbdocs to INSTALLED_APPS
 
 Add `labbdocs` to your Django project's `INSTALLED_APPS`:
 
@@ -24,9 +24,9 @@ INSTALLED_APPS = [
 ]
 ```
 
-### 2. Configure LABB_DOCS
+### 2. Configure LABB_DOCS in settings
 
-Set up your documentation configuration in your Django settings:
+Set up your documentation configuration in Django settings:
 
 ```python
 # settings.py
@@ -50,7 +50,7 @@ LABB_DOCS = {
 }
 ```
 
-### 3. Include URLs
+### 3. Include labbdocs URLs
 
 Add labbdocs URLs to your main URL configuration:
 
@@ -64,7 +64,7 @@ urlpatterns = [
 ]
 ```
 
-### 4. Build Documentation
+### 4. Build documentation
 
 Use the management command to build your documentation:
 

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/blog/index.md

@@ -1,6 +1,7 @@
 ---
 title: labb blog
-description: labb blog posts and articles
+description: "labb blog: Django UI tutorials, releases, and opinions on django-cotton, Tailwind CSS, and daisyUI. Updates from the labb.io team."
+keywords: "labb blog, django ui blog, django components tutorial, labb.io, django-cotton news"
 doc_show_toc: false
 doc_hide_title: true
 doc_hide_drawer: true

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/blog/posts/1_introducing-labb-and-the-roadmap.md

@@ -1,6 +1,7 @@
 ---
 title: Introducing labb, and the roadmap
-description: Meet labb - a modern UI component library for Django, and discover our roadmap for future development.
+description: "Meet labb, a Django UI component library built with django-cotton and daisyUI. Our roadmap for components, docs, and the labb.io django component library."
+keywords: "labb django, django component library, django-cotton, daisyui django, labb roadmap, django ui components"
 published_time: 2025-12-29
 modified_time: 2025-12-29
 author: zadiq
@@ -57,6 +58,6 @@ Pre-built templates and components to kickstart your Django projects even faster
 
 labb is just getting started, and your feedback is invaluable. Try it out in your projects, share your thoughts, share with other developers, and let me know what features and components you need most. Together, we can make building modern Django applications faster and more enjoyable.
 
-Get involved by joining our [GitHub Discussions](https://github.com/labbhq/labb/discussions) or [join our Discord server](https://discord.gg/34eBUJMQv2).
+Get involved by joining our [GitHub Discussions](https://github.com/labbhq/labb/discussions).
 
 Happy labbing! 🚀

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/1_getting_started/1_introduction.md

@@ -1,6 +1,7 @@
 ---
 title: Introduction
-description: Beautiful, accessible, and customizable UI components for your Django projects.
+description: "labb is a Django UI component library: build interfaces with django-cotton, Tailwind CSS, and daisyUI 5. Server-rendered HTML, optional Alpine.js, 50+ components."
+keywords: "django ui components, django component library, django-cotton, labb django, tailwind django, daisyui django, django frontend"
 doc_show_toc: False
 ---
 {% load static %}
@@ -42,20 +43,22 @@ doc_show_toc: False
 
 **Developer Friendly** — Powerful CLI for setup, component inspection, and AI-assisted development. Works seamlessly with Cursor, VSCode Copilot, and other AI tools.
 
-## What You Get
+**Reactive When You Need It** — Components are zero-JS by default. Add Alpine.js interactivity with `.x` variants on a per-component basis. No bundler, no build step, nothing loads unless you use it.
 
-- **40+ Components** (in progress) — Buttons, cards, modals, drawers, forms, and more
+## Django UI Components Included
+
+- **50+ Components** — Buttons, cards, modals, drawers, forms, and more
 - **Extensive examples** — Each component has multiple examples with different variations and use cases
 - **Icon Libraries** — 2,800+ Remix icons and more via optional `labbicons` package
 - **Theme Support** — Light, dark, and custom themes out of the box
 - **Zero Config** — `labb init --defaults` and you're ready to go
 - **No JavaScript Build Step** — Components work without JavaScript by default
+- **Opt-in Reactivity** — Alpine.js-powered `.x` variants for runtime prop changes, zero overhead on pages that don't use them
 - **CLI Tool** — `labb` command for project setup, component inspection, and AI-assisted development
 
 
-## Coming Soon
+## Coming Soon
 
 - IDE extensions for autocomplete and documentation
 - More icon packs
-- Seamless integration with AlpineJS for interactive component properties
 - Starter kits, blocks and templates.

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

@@ -1,11 +1,12 @@
 ---
 title: Installation
-description: How to install and set up labb in your Django project
+description: "Install labb in new or existing Django projects: labbstart for greenfield apps, or pip install labbui with django-cotton. Tailwind CSS and daisyUI 5 ready."
+keywords: "install labb django, labb django setup, django-cotton install, labbstart, pip labbui, tailwind django project"
 ---
 
 {% load docs_tags %}
 
-## New Project (Recommended)
+## New Django Project with labbstart
 
 The fastest way to get started is with **labbstart**, which scaffolds a new Django project with labb pre-configured.
 
@@ -146,7 +147,7 @@ Add `<c-lb.m.dependencies />` to your base template's `<head>` section:
 {% endverbatim %}
 </c-lbdocs.codeblock.title>
 
-<c-lb.alert variant="warning" style="outline" class="mt-4">
+<c-lb.alert variant="warning" alertStyle="outline" class="mt-4">
 <span>Without `<c-lb.m.dependencies />`, components will not have the correct styling and interactive features may not work.</span>
 </c-lb.alert>
 
@@ -187,9 +188,30 @@ Use labb components in your templates with HTML-like syntax:
 
 Browse <a href="{% doc_url '1_actions/button.md' 'ui' %}">component documentation</a> for all available components.
 
+### Reactive Components
+
+Add `.x` to any component name to get a reactive twin. Props can be changed at runtime using Alpine.js:
+
+<c-lbdocs.codeblock.title title="templates/example.html">
+{% verbatim %}
+```html
+<div x-data="{ btn: { variant: 'primary' } }">
+    <c-lb.button.x x-model="btn" variant="primary">
+        <span x-text="btn.variant"></span> button
+    </c-lb.button.x>
+
+    <c-lb.button variant="ghost" @click="btn.variant = 'success'">Change</c-lb.button>
+</div>
+```
+{% endverbatim %}
+</c-lbdocs.codeblock.title>
+
+See the <a href="{% doc_url '2_concepts/1_reactivity.md' 'guide' %}">Reactivity guide</a> for the full picture.
+
 ## Next Steps
 
-- <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 '2_concepts/2_theming.md' 'guide' %}">Theming</a> — Customize colors and themes
+- <a href="{% doc_url '2_concepts/3_building_css.md' 'guide' %}">Building CSS</a> — CSS build process and production builds
+- <a href="{% doc_url '2_concepts/1_reactivity.md' 'guide' %}">Reactivity</a> — Add Alpine.js-powered interactivity to components with `.x` variants
 - <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-0.4.0}/labbdocs/content/guide/1_getting_started/3_changelog.md

@@ -1,12 +1,27 @@
 ---
 title: Changelog
-description: Release history and version notes for labb
+description: "Release history and version notes for labb: django component library, labbui, and labbdocs."
+keywords: "labb changelog, labbui release notes, django labb versions"
 ---
 
 {% load docs_tags %}
 
 
-## 0.3.0 <c-lb.badge size="sm">latest</c-lb.badge>
+## 0.4.0 <c-lb.badge size="sm">latest</c-lb.badge>
+
+**Apr 19, 2026**
+
+### Features
+- **AlpineJS integration** — opt-in client-side reactivity via `.x` component variants (e.g. `<c-lb.button.x>`). Alpine is only injected when a reactive variant is used; static pages stay zero-JS. New `window.lb` helpers (`extendComponent`, `lbProps`) for extending reactive components. ([#31](https://github.com/labbhq/labb/issues/31))
+- **Charts** — new Chart.js-backed components (`chart.bar`, `chart.line`, `chart.pie`, `chart.doughnut`, `chart.radar`, `chart.polar-area`, `chart.scatter`, `chart.bubble`) with live DaisyUI theming, auto-palette colouring, `-light` translucent variants, and `x-model` reactivity. `<c-lb.chart />` page-level provider for global Chart.js config.
+- **Icons** — added ~85 new Remix icons (AI/ML, signal, chat, painting, network, chart, misc).
+
+### Fixes
+- **Alert** — renamed the `style` prop to `alertStyle` to avoid clashing with the HTML `style` attribute on cotton passthrough.
+
+---
+
+## 0.3.0
 
 **Mar 08, 2026**
 

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/1_getting_started/4_roadmap.md

@@ -1,6 +1,7 @@
 ---
 title: Roadmap
-description: Planned features and future direction for labb
+description: "labb roadmap: planned django ui components, tooling, and docs for the django component library toward v1."
+keywords: "labb roadmap, django ui roadmap, labb future features"
 doc_show_toc: false
 ---
 
@@ -20,15 +21,15 @@ This roadmap outlines the planned direction for labb. Priorities may shift based
             </c-lb.timeline.end>
         </c-slot>
     </c-lb.timeline.item>
-    <c-lb.timeline.item variant="warning" icon="rmx.loader-4">
+    <c-lb.timeline.item variant="success" icon="rmx.checkbox-circle">
         <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>
+                <p class="text-sm">AlpineJS integration and Charts</p>
             </c-lb.timeline.end>
         </c-slot>
     </c-lb.timeline.item>
-    <c-lb.timeline.item icon="rmx.time">
+    <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">IDE extensions</span>
@@ -36,14 +37,6 @@ This roadmap outlines the planned direction for labb. Priorities may shift based
             </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">

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/1_getting_started/5_credits.md

@@ -1,6 +1,7 @@
 ---
 title: Credits
-description: The projects and people that make labb possible
+description: "Credits: Django, django-cotton, Tailwind CSS, daisyUI, Alpine.js, and projects behind the labb django component library."
+keywords: "labb credits, django-cotton credits, daisyui tailwind django"
 ---
 
 {% load docs_tags %}

labbdocs-0.4.0/labbdocs/content/guide/2_concepts/1_reactivity.md

@@ -0,0 +1,98 @@
+---
+title: "Reactivity"
+description: "Alpine.js reactivity in labb Django components: use `.x` variants for runtime props; no JS by default. django-cotton, Tailwind CSS, and daisyUI 5 compatible."
+keywords: "labb alpine.js django, django reactivity, django-cotton alpine, labb .x component, server-side rendering django"
+---
+
+{% load docs_tags %}
+
+labb is zero-JS by default, but components are integrated with [Alpine.js](https://alpinejs.dev/) to provide reactivity. This is available through the `.x` twin of each component, letting you change visual props at runtime without a page reload. Alpine is only loaded on pages where a `.x` component is used.
+
+## The `.x` variant
+
+Every reactive-capable component has an `.x` version. For example, `<c-lb.button.x>` is the reactive twin of `<c-lb.button>`. Drop it in as a replacement. The server still renders the initial HTML, and Alpine takes over from there:
+
+```html
+<!-- Before: plain server-rendered button -->
+<c-lb.button variant="primary" size="lg">Save</c-lb.button>
+
+<!-- After: same output, but now Alpine-powered -->
+<c-lb.button.x variant="primary" size="lg">Save</c-lb.button.x>
+```
+
+## Usage
+
+### Initial props
+
+Pass props as HTML attributes on the `.x` component, the same as the regular version. They seed the initial server render and are also read by Alpine as the starting state:
+
+<c-lbdocs.component_example path="button/reactive-initial" style="inline" />
+
+### Changing props at runtime
+
+To change props at runtime, bind an object containing props to the `.x` component using `x-model`.  The object can live anywhere Alpine can see it: inline `x-data`, a registered `Alpine.data` component, or any ancestor scope.
+
+<c-lb.alert variant="info" alertStyle="outline" class="text-sm mb-6">
+ <span> Not every prop can be changed reactively. In the API table, reactive props are marked with a <c-lbi n="rmx.flashlight" w="0.85em" h="0.85em" class="text-warning inline align-middle" /> icon.</span>
+</c-lb.alert>
+
+<c-lbdocs.component_example path="button/reactive-simple" style="stacked" />
+
+
+### Adding your own behavior
+
+When you need the component to do more than just swap classes (custom state, async actions, event handling), use `lb.extendComponent` to build on top of the built-in Alpine component rather than replace it. Your code gets added alongside the class management logic, so both work together.
+
+Inside your methods, use `this.lbProps` to read or change the component's reactive props:
+
+```js
+this.lbProps.variant = 'success';
+this.lbProps.size = 'lg';
+```
+
+<c-lbdocs.component_example path="button/reactive-extend" style="stacked" />
+
+Initial props from HTML attributes are still seeded automatically. If you need a custom `init()`, call the base to keep that:
+
+```js
+Alpine.data('myBtnComp', lb.extendComponent('button', {
+    init() {
+        Object.getPrototypeOf(this).init?.call(this);
+        // your custom init...
+    }
+}));
+```
+
+See the [`window.lb` reference]({% doc_url '3_references/5_window_lb.md' 'guide' %}) for full `lb.extendComponent` documentation.
+
+### Replacing the Alpine component
+
+You can also pass your own `x-data` entirely, which bypasses the built-in component:
+
+```html
+<c-lb.button.x x-data="{ myCustomSetup() { ... } }" variant="primary">
+    Custom Alpine
+</c-lb.button.x>
+```
+
+When you do this, the built-in class management no longer applies. You are responsible for handling reactive classes yourself.
+
+## Prop format
+
+Reactive props are plain JavaScript object keys matching the **camelCase variable names** from the API table. These are the same keys used in `lbProps` when extending:
+
+```js
+{
+    variant: 'primary',   // btn-primary
+    size: 'lg',           // btn-lg
+    btnStyle: 'outline',  // btn-outline
+    behavior: '',         // '' = no class applied
+}
+```
+
+An empty string means "no value". Use it to clear a prop back to its unstyled state. You only need to include the props you want to control; the rest stay at their server-rendered defaults.
+
+
+## Overriding the Alpine.js source
+
+By default, labb serves Alpine from its own bundled static file. To use a CDN or your own build, set `ALPINE_JS_PATH` in your Django settings. See the [Django settings reference]({% doc_url '3_references/2_django_settings.md' 'guide' %}#alpine_js_path) for details.

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

@@ -1,13 +1,14 @@
 ---
 title: "Theming"
 description: "Customize themes, create custom color schemes, and integrate daisyUI theming with labb components."
+keywords: "labb theming django, daisyui themes django, tailwind themes django, django dark mode, labb_theme tag"
 ---
 
 {% 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
+## Configuring labb themes in Django
 
 Add the `{% verbatim %}{% labb_theme %}{% endverbatim %}` tag to your `<html>` element and register the theme persistence URL:
 
@@ -47,7 +48,7 @@ urlpatterns = [
 
 `{% 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">
+<c-lb.alert variant="info" alertStyle="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>
 

labbdocs-0.3.1/labbdocs/content/guide/2_concepts/2_building_css.md → labbdocs-0.4.0/labbdocs/content/guide/2_concepts/3_building_css.md

@@ -1,6 +1,7 @@
 ---
 title: Building CSS
-description: Understanding the CSS building flow in labb CLI
+description: "Build Tailwind CSS for labb: CLI scans django-cotton templates, generates CSS, and integrates daisyUI with your Django project."
+keywords: "labb build css, tailwind django labb, labb dev watcher, django-cotton tailwind"
 ---
 
 One of the main features of the labb CLI is the ability to automatically detect CSS classes based on component attributes in templates.
@@ -115,7 +116,7 @@ labb build --watch
 labb dev
 ```
 
-<c-lb.alert variant="info" style="outline">
+<c-lb.alert variant="info" alertStyle="outline">
 <span>`labb dev` is a shortcut for `labb build -w -s` (watch + scan mode).</span>
 </c-lb.alert>
 

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/3_references/0_labb_cli.md

@@ -1,6 +1,7 @@
 ---
 title: labb CLI
-description: Complete reference for the labb command-line interface
+description: "Complete reference for the labb CLI: inspect components, search icons, build CSS, and scaffold Django projects with labb and django-cotton."
+keywords: "labb cli, labb components inspect, labb icons search, labb dev, django labb commands"
 ---
 
 The `labb` command-line interface provides a comprehensive set of tools for managing your Django projects using labb.

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/3_references/1_config_yaml.md

@@ -1,6 +1,7 @@
 ---
 title: labb.yaml
-description: Configuration options for your labb project
+description: "labb.yaml configuration for Django projects: paths, Tailwind CSS, daisyUI themes, and labb CLI defaults."
+keywords: "labb.yaml, labb config django, labb project configuration"
 ---
 
 {% load docs_tags %}

labbdocs-0.4.0/labbdocs/content/guide/3_references/2_django_settings.md

@@ -0,0 +1,106 @@
+---
+title: settings.py
+description: "LABB_SETTINGS in Django settings.py: configure labb, django-cotton integration, and optional labbdocs for your django ui project."
+keywords: "labb django settings, LABB_SETTINGS, django-cotton settings"
+---
+
+## Overview of LABB_SETTINGS
+
+All labb-specific settings live under a single `LABB_SETTINGS` dict in your Django `settings.py`:
+
+<c-lbdocs.codeblock.title title="settings.py">
+```python
+LABB_SETTINGS = {
+    'DEFAULT_THEME': 'labb-light',
+    'ALPINE_JS_PATH': 'https://cdn.jsdelivr.net/npm/alpinejs@3/dist/cdn.min.js',
+}
+```
+</c-lbdocs.codeblock.title>
+
+Only set what you need — all settings have built-in defaults and are fully optional.
+
+## Settings Reference
+
+### `DEFAULT_THEME`
+
+<c-lbdocs.indented_block>
+
+| | |
+|---|---|
+| **Default** | `"__system__"` |
+| **Type** | `str` |
+
+The theme applied to new users who have not yet made a selection. Can be any daisyUI theme registered in your project's `input.css`. The special value `"__system__"` defers to the OS-level light/dark preference.
+
+```python
+LABB_SETTINGS = {
+    'DEFAULT_THEME': 'labb-light',
+}
+```
+
+</c-lbdocs.indented_block>
+
+### `ALPINE_JS_PATH`
+
+<c-lbdocs.indented_block>
+
+| | |
+|---|---|
+| **Default** | `"labb/js/alpine/alpine.min.js"` |
+| **Type** | `str` |
+
+Path to the Alpine.js file loaded when reactive (`.x`) components are used on a page. By default, labb serves Alpine from its own bundled static file.
+
+- **Static path** — resolved via Django's static files system, emitted as `<script defer src="...">`
+- **Full URL** (`http://` / `https://`) — emitted as-is, useful for CDN or custom builds
+
+```python
+LABB_SETTINGS = {
+    # Use jsDelivr CDN instead of the bundled file
+    'ALPINE_JS_PATH': 'https://cdn.jsdelivr.net/npm/alpinejs@3/dist/cdn.min.js',
+}
+```
+
+See the [Reactivity guide]({% doc_url '2_concepts/1_reactivity.md' 'guide' %}) for more detail on how Alpine loading works.
+
+</c-lbdocs.indented_block>
+
+---
+
+## Functions
+
+### `get_labb_setting()`
+
+<c-lbdocs.indented_block>
+
+Retrieves a setting from `LABB_SETTINGS` with fallback to labb's built-in defaults:
+
+```python
+from labb.django_settings import get_labb_setting
+
+theme = get_labb_setting('DEFAULT_THEME')
+alpine_path = get_labb_setting('ALPINE_JS_PATH')
+```
+
+**Signature:** `get_labb_setting(key, default=None)`
+
+| Parameter | Description |
+|---|---|
+| `key` | Setting name to retrieve |
+| `default` | Fallback if the key is absent from both `LABB_SETTINGS` and labb's defaults |
+
+</c-lbdocs.indented_block>
+
+### `get_default_theme()`
+
+<c-lbdocs.indented_block>
+
+Convenience function to get the current default theme setting.
+
+```python
+from labb.django_settings import get_default_theme
+
+theme = get_default_theme()
+```
+
+</c-lbdocs.indented_block>

{labbdocs-0.3.1 → labbdocs-0.4.0}/labbdocs/content/guide/3_references/3_lb_tags.md

@@ -1,6 +1,7 @@
 ---
 title: lb_tags
-description: Template tags for labb components and theming in Django templates
+description: "Django template tags for labb: labb_theme, labb_css, and helpers for django-cotton components in templates."
+keywords: "labb template tags, labb_theme django, django labb_tags"
 ---
 
 {% load docs_tags %}
@@ -198,4 +199,21 @@ Returns the raw theme value from the user's session or the default theme from Dj
 </c-lbdocs.indented_block>
 
 
+### `lb_alpine_script`
+
+<c-lbdocs.indented_block>
+Emits a deferred Alpine.js `<script>` tag resolved from `LABB_SETTINGS["ALPINE_JS_PATH"]`. Use this when you need Alpine on a page without using `<c-lb.m.dependencies alpine />`.
+
+**Usage:**
+{% verbatim %}
+```html
+{% load lb_tags %}
+{% lb_alpine_script %}
+```
+{% endverbatim %}
+
+**Returns:**
+- `<script defer src="..."></script>` pointing to the configured Alpine path
+</c-lbdocs.indented_block>
+
 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.