chore: CI workflow, CHANGELOG, explicit wheel includes — v0.1.0 complete

- Add .github/workflows/ci.yml with matrix for Python 3.11/3.12/3.13
- Replace [Unreleased] with [0.1.0] release notes and Technical Notes
- Add explicit [tool.hatch.build] include for templates + static in pyproject.toml
- Fix 16 ruff lint/format issues across tests (E402 noqa, F401 unused imports,
  E501 long line, E741 ambiguous var, I001 unsorted imports, UP035 typing import,
  ruff format on 21 files)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: fsecada01

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv pip install -e ".[dev]"
+
+      - name: Install Playwright browsers
+        run: playwright install chromium --with-deps
+
+      - name: Lint
+        run: ruff check src tests
+
+      - name: Format check
+        run: ruff format --check src tests
+
+      - name: Unit tests
+        run: pytest tests/unit/ -q --tb=short
+
+      - name: Integration tests
+        run: pytest tests/integration/ -q --tb=short
+
+      - name: E2E tests
+        run: pytest tests/e2e/ -q --tb=short --browser chromium

CHANGELOG.md

@@ -1,6 +1,21 @@
 # Changelog
 
-## [Unreleased]
+## [0.1.0] — 2026-04-25
 
 ### Added
-- Initial package scaffold
+- Initial release: Bulma theme (Jinja2/JinjaX + django-cotton)
+- 14 components: FormField, Select, Textarea, CheckboxGroup, Modal, Notification,
+  Progress, Card, Table, Pagination, Panel, Navbar, Breadcrumb, Tabs
+- Django AppConfig with auto-registration of COTTON_DIRS
+- FastAPI `install_cf_ui()` with JinjaX `add_folder(prefix="Cf")` registration
+- Litestar `install_cf_ui()` with Jinja2 template directory injection
+- CDN asset tags: `{% cf_ui_head %}` / `{% cf_ui_body %}` (Django + Jinja2 macros)
+- `cf_ui_alpine.js`: named Alpine components (cfModal, cfNavbar, cfPanel, cfTabs)
+  and `$store.cf` global store (notify, modal.open/close via custom events)
+- Three-tier test suite: unit (93 tests), integration (8 tests), E2E Playwright (17 tests, js_on + js_off)
+- Stubs for Bootstrap, Foundation, Fomantic UI, DaisyUI themes
+
+### Technical Notes
+- django-cotton 2.x: uses `<c-vars>` (not `<c-props>`) for variable declarations
+- JinjaX 0.41+: uses `add_folder()` (not `add_path()`), `class` is reserved — use `extra_class`
+- Alpine modal control uses `cf-modal-open`/`cf-modal-close` custom events (not `_x_dataStack`)

pyproject.toml

@@ -58,6 +58,13 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["src/cf_ui"]
 
+[tool.hatch.build]
+include = [
+    "src/cf_ui/**/*.py",
+    "src/cf_ui/templates/**",
+    "src/cf_ui/static/**",
+]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["src"]

tests/e2e/_django_e2e_server.py

@@ -4,6 +4,7 @@
 Run as a subprocess so it gets its own Python process and Django configuration,
 isolated from the pytest process's Django settings.
 """
+
 import os
 import sys
 from pathlib import Path
@@ -22,12 +23,13 @@
 # Configure Django with cotton-enabled settings
 os.environ["DJANGO_SETTINGS_MODULE"] = "tests.e2e._e2e_django_settings"
 
-import django
+import django  # noqa: E402
 
 django.setup()
 
-from django.core.handlers.wsgi import WSGIHandler
-from wsgiref.simple_server import make_server
+from wsgiref.simple_server import make_server  # noqa: E402
+
+from django.core.handlers.wsgi import WSGIHandler  # noqa: E402
 
 httpd = make_server(HOST, PORT, WSGIHandler())
 httpd.serve_forever()

tests/e2e/_e2e_django_settings.py

@@ -8,6 +8,7 @@
 It MUST NOT be imported by the main pytest process to avoid polluting
 the shared Django settings used by unit and integration tests.
 """
+
 from pathlib import Path
 
 from cf_ui import JINJA_TEMPLATES_DIR

tests/e2e/conftest.py

@@ -2,8 +2,8 @@
 import sys
 import threading
 import time
+from collections.abc import Generator
 from pathlib import Path
-from typing import Generator
 
 import pytest
 import uvicorn

tests/e2e/test_bulma_cotton.py

@@ -1,6 +1,5 @@
 import re
 
-import pytest
 from playwright.sync_api import expect
 
 

tests/integration/conftest.py

@@ -17,6 +17,7 @@
 need it. The session-scoped fixture below ensures ROOT_URLCONF is set for all
 integration tests regardless of which conftest configured Django first.
 """
+
 import os
 
 import django

tests/integration/cotton_app/settings.py

@@ -11,15 +11,17 @@
     "cf_ui.django.CfUiConfig",
 ]
 DATABASES = {"default": {"ENGINE": "django.db.backends.sqlite3", "NAME": ":memory:"}}
-TEMPLATES = [{
-    "BACKEND": "django.template.backends.django.DjangoTemplates",
-    "DIRS": [BASE_DIR / "templates"],
-    "APP_DIRS": True,
-    "OPTIONS": {
-        "context_processors": [],
-        "libraries": {"cf_ui": "cf_ui.templatetags.cf_ui"},
-    },
-}]
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [BASE_DIR / "templates"],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [],
+            "libraries": {"cf_ui": "cf_ui.templatetags.cf_ui"},
+        },
+    }
+]
 CF_UI_THEME = "bulma"
 ROOT_URLCONF = "tests.integration.cotton_app.urls"
 STATIC_URL = "/static/"

tests/integration/cotton_app/urls.py

@@ -1,4 +1,5 @@
 from django.urls import path
+
 from tests.integration.cotton_app import views
 
 urlpatterns = [