django-cfg 1.4.92__py3-none-any.whl → 1.4.94__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.92"
+__version__ = "1.4.94"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/apps/frontend/views.py

@@ -4,14 +4,17 @@ JWT tokens are automatically injected into HTML responses for authenticated user
 This is specific to Next.js frontend apps only.
 
 Features:
-- Automatic extraction of ZIP archives on first request
+- Automatic extraction of ZIP archives with smart update detection
+- Auto-reextraction when ZIP is modified within last 5 minutes
 - SPA routing with fallback strategies
 - JWT token injection for authenticated users
 """
 
 import logging
 import zipfile
+import shutil
 from pathlib import Path
+from datetime import datetime, timedelta
 from django.http import Http404, HttpResponse, FileResponse
 from django.views.static import serve
 from django.views import View
@@ -23,19 +26,101 @@ from rest_framework_simplejwt.tokens import RefreshToken
 logger = logging.getLogger(__name__)
 
 
+class ZipExtractionMixin:
+    """
+    Mixin for automatic ZIP extraction with age-based refresh.
+
+    Provides intelligent ZIP archive handling:
+    - Auto-extraction when directory doesn't exist
+    - Auto-reextraction when extracted directory is older than 10 minutes
+    - Simple age-based logic (no ZIP timestamp comparison needed)
+
+    Usage:
+        class MyView(ZipExtractionMixin, View):
+            app_name = 'myapp'  # Will look for myapp.zip
+    """
+
+    # Maximum age of extracted directory before re-extraction (in seconds)
+    MAX_DIRECTORY_AGE = 600  # 10 minutes = 600 seconds
+
+    def extract_zip_if_needed(self, base_dir: Path, zip_path: Path, app_name: str) -> bool:
+        """
+        Extract ZIP archive if needed based on directory age.
+
+        Args:
+            base_dir: Target directory for extraction
+            zip_path: Path to ZIP archive
+            app_name: Name of the app (for logging)
+
+        Returns:
+            bool: True if extraction succeeded or not needed, False if failed
+        """
+        should_extract = False
+
+        # Priority 1: If directory doesn't exist at all - always extract
+        if not base_dir.exists():
+            should_extract = True
+            logger.info(f"[{app_name}] Directory doesn't exist, will extract")
+
+        # Priority 2: Directory exists - check if it's too old
+        else:
+            # Get directory modification time
+            dir_mtime = datetime.fromtimestamp(base_dir.stat().st_mtime)
+            directory_age = (datetime.now() - dir_mtime).total_seconds()
+
+            # If directory is older than MAX_DIRECTORY_AGE - re-extract
+            if directory_age > self.MAX_DIRECTORY_AGE:
+                logger.info(f"[{app_name}] Directory is old ({directory_age:.0f}s > {self.MAX_DIRECTORY_AGE}s), re-extracting")
+                try:
+                    shutil.rmtree(base_dir)
+                    should_extract = True
+                except Exception as e:
+                    logger.error(f"[{app_name}] Failed to remove old directory: {e}")
+                    return False
+            else:
+                logger.debug(f"[{app_name}] Directory is fresh ({directory_age:.0f}s), using existing")
+
+        # Extract ZIP if needed
+        if should_extract:
+            if zip_path.exists():
+                logger.info(f"[{app_name}] Extracting {zip_path.name} to {base_dir}...")
+                try:
+                    base_dir.parent.mkdir(parents=True, exist_ok=True)
+                    with zipfile.ZipFile(zip_path, 'r') as zip_ref:
+                        zip_ref.extractall(base_dir)
+                    logger.info(f"[{app_name}] Successfully extracted {zip_path.name}")
+                    return True
+                except Exception as e:
+                    logger.error(f"[{app_name}] Failed to extract: {e}")
+                    return False
+            else:
+                logger.error(f"[{app_name}] ZIP not found: {zip_path}")
+                return False
+
+        # Directory exists and is fresh
+        return True
+
+
 @method_decorator(xframe_options_exempt, name='dispatch')
-class NextJSStaticView(View):
+class NextJSStaticView(ZipExtractionMixin, View):
     """
     Serve Next.js static build files with automatic JWT token injection.
 
     Features:
     - Serves Next.js static export files like a static file server
+    - Smart ZIP extraction: auto-refreshes when directory older than 10 minutes
     - Automatically injects JWT tokens for authenticated users
     - Tokens injected into HTML responses only
     - Handles Next.js client-side routing (.html fallback)
     - Automatically serves index.html for directory paths
     - X-Frame-Options exempt to allow embedding in iframes
 
+    ZIP Extraction Logic:
+    - If directory doesn't exist: extract from ZIP
+    - If directory older than 10 minutes: remove and re-extract
+    - If directory fresh (< 10 min): use existing files
+    - This enables auto-refresh during development while caching in production
+
     Path resolution examples:
     - /cfg/admin/              → /cfg/admin/index.html
     - /cfg/admin/private/      → /cfg/admin/private/index.html (if exists)
@@ -51,22 +136,16 @@ class NextJSStaticView(View):
         import django_cfg
 
         base_dir = Path(django_cfg.__file__).parent / 'static' / 'frontend' / self.app_name
+        zip_path = Path(django_cfg.__file__).parent / 'static' / 'frontend' / f'{self.app_name}.zip'
 
-        # Check if ZIP archive exists and extract if needed
+        # Extract ZIP if needed using mixin
+        if not self.extract_zip_if_needed(base_dir, zip_path, self.app_name):
+            return render(request, 'frontend/404.html', status=404)
+
+        # Ensure directory exists
         if not base_dir.exists():
-            zip_path = Path(django_cfg.__file__).parent / 'static' / 'frontend' / f'{self.app_name}.zip'
-            if zip_path.exists():
-                logger.info(f"Extracting {self.app_name}.zip to {base_dir}...")
-                try:
-                    base_dir.parent.mkdir(parents=True, exist_ok=True)
-                    with zipfile.ZipFile(zip_path, 'r') as zip_ref:
-                        zip_ref.extractall(base_dir)
-                    logger.info(f"Successfully extracted {self.app_name}.zip")
-                except Exception as e:
-                    logger.error(f"Failed to extract {self.app_name}.zip: {e}")
-                    return render(request, 'frontend/404.html', status=404)
-            else:
-                return render(request, 'frontend/404.html', status=404)
+            logger.error(f"[{self.app_name}] Directory doesn't exist after extraction attempt")
+            return render(request, 'frontend/404.html', status=404)
 
         original_path = path  # Store for logging
 

django_cfg/modules/nextjs_admin/views.py

@@ -2,6 +2,12 @@
 Views for Next.js admin integration.
 
 Serves Next.js static files with SPA routing support and JWT injection.
+
+Features:
+- Automatic extraction of ZIP archives with age-based refresh
+- Auto-reextraction when directory is older than 10 minutes
+- SPA routing with fallback strategies
+- JWT token injection for authenticated users
 """
 
 import logging
@@ -13,24 +19,31 @@ from django.views.decorators.clickjacking import xframe_options_exempt
 from django.utils.decorators import method_decorator
 from django.contrib.auth.mixins import LoginRequiredMixin
 from django.shortcuts import render
+from django_cfg.apps.frontend.views import ZipExtractionMixin
 
 logger = logging.getLogger(__name__)
 
 
 @method_decorator(xframe_options_exempt, name='dispatch')
-class NextJsAdminView(LoginRequiredMixin, View):
+class NextJsAdminView(ZipExtractionMixin, LoginRequiredMixin, View):
     """
     Serve Next.js admin panel with JWT injection and SPA routing.
 
     Features:
     - Serves Next.js static build files
+    - Smart ZIP extraction: auto-refreshes when directory older than 10 minutes
     - Automatic JWT token injection for authenticated users
     - SPA routing support (path/to/route → path/to/route/index.html)
     - Development mode support (proxies to dev server conceptually)
 
+    ZIP Extraction Logic:
+    - If directory doesn't exist: extract from ZIP
+    - If directory older than 10 minutes: remove and re-extract
+    - If directory fresh (< 10 min): use existing files
+
     URL Examples:
-        /cfg/admin/                    → private.html (or index.html)
-        /cfg/admin/private/centrifugo  → private/centrifugo/index.html
+        /cfg/admin/                    → admin/index.html
+        /cfg/admin/crypto              → admin/crypto/index.html
         /cfg/admin/_next/static/...    → _next/static/...
     """
 
@@ -38,7 +51,6 @@ class NextJsAdminView(LoginRequiredMixin, View):
         """Serve Next.js files with JWT injection and SPA routing."""
         from django_cfg.core.config import get_current_config
         import django_cfg
-        import zipfile
 
         config = get_current_config()
         if not config or not config.nextjs_admin:
@@ -48,33 +60,24 @@ class NextJsAdminView(LoginRequiredMixin, View):
 
         # Use extracted directory from static/frontend/nextjs_admin/
         base_dir = Path(django_cfg.__file__).parent / 'static' / 'frontend' / 'nextjs_admin'
+        zip_path = Path(django_cfg.__file__).parent / 'static' / 'frontend' / 'nextjs_admin.zip'
+
+        # Fallback: Try solution project static directory
+        if not zip_path.exists():
+            from django.conf import settings
+            solution_zip = Path(settings.BASE_DIR) / 'static' / 'nextjs_admin.zip'
+            if solution_zip.exists():
+                zip_path = solution_zip
+                logger.info(f"[nextjs_admin] Using ZIP from solution project: {solution_zip}")
 
-        # Check if ZIP archive exists and extract if needed
+        # Extract ZIP if needed using mixin
+        if not self.extract_zip_if_needed(base_dir, zip_path, 'nextjs_admin'):
+            return render(request, 'frontend/404.html', status=404)
+
+        # Ensure directory exists
         if not base_dir.exists():
-            # Try django_cfg package location first
-            zip_path = Path(django_cfg.__file__).parent / 'static' / 'frontend' / 'nextjs_admin.zip'
-
-            # Fallback: Try solution project static directory
-            if not zip_path.exists():
-                from django.conf import settings
-                solution_zip = Path(settings.BASE_DIR) / 'static' / 'nextjs_admin.zip'
-                if solution_zip.exists():
-                    zip_path = solution_zip
-                    logger.info(f"Using ZIP from solution project: {solution_zip}")
-
-            if zip_path.exists():
-                logger.info(f"Extracting nextjs_admin.zip to {base_dir}...")
-                try:
-                    base_dir.parent.mkdir(parents=True, exist_ok=True)
-                    with zipfile.ZipFile(zip_path, 'r') as zip_ref:
-                        zip_ref.extractall(base_dir)
-                    logger.info(f"Successfully extracted nextjs_admin.zip from {zip_path}")
-                except Exception as e:
-                    logger.error(f"Failed to extract nextjs_admin.zip: {e}")
-                    return render(request, 'frontend/404.html', status=404)
-            else:
-                logger.error(f"nextjs_admin.zip not found in django_cfg or solution project")
-                return render(request, 'frontend/404.html', status=404)
+            logger.error(f"[nextjs_admin] Directory doesn't exist after extraction attempt")
+            return render(request, 'frontend/404.html', status=404)
 
         static_dir = base_dir
 

django_cfg/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.92"
-description = "Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django."
+version = "1.4.94"
+description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
-keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "ai-agents", "enterprise-django", "django-settings", "type-safe-config",]
+keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]
 classifiers = [ "Development Status :: 4 - Beta", "Framework :: Django", "Framework :: Django :: 5.2", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Typing :: Typed",]
 requires-python = ">=3.12,<3.14"
 dependencies = [ "pydantic>=2.11.0,<3.0", "pydantic[email]>=2.11.0,<3.0", "PyYAML>=6.0,<7.0", "click>=8.2.0,<9.0", "questionary>=2.1.0,<3.0", "rich>=14.0.0,<15.0", "cloudflare>=4.3.0,<5.0", "loguru>=0.7.0,<1.0", "colorlog>=6.9.0,<7.0", "cachetools>=5.3.0,<7.0", "toml>=0.10.2,<0.11.0", "ngrok>=1.5.1; python_version>='3.12'", "psycopg[binary,pool]>=3.2.0,<4.0", "dj-database-url>=3.0.0,<4.0", "whitenoise>=6.8.0,<7.0", "django-cors-headers>=4.7.0,<5.0", "djangorestframework>=3.16.0,<4.0", "djangorestframework-simplejwt>=5.5.0,<6.0", "djangorestframework-simplejwt[token-blacklist]>=5.5.0,<6.0", "drf-nested-routers>=0.94.0,<1.0", "django-filter>=25.0,<26.0", "django-ratelimit>=4.1.0,<5.0.0", "drf-spectacular>=0.28.0,<1.0", "drf-spectacular-sidecar>=2025.8.0,<2026.0", "django-json-widget>=2.0.0,<3.0", "django-import-export>=4.3.0,<5.0", "django-extensions>=4.1.0,<5.0", "django-constance>=4.3.0,<5.0", "django-unfold>=0.64.0,<1.0", "django-redis>=6.0.0,<7.0", "redis>=6.4.0,<7.0", "hiredis>=2.0.0,<4.0", "dramatiq[redis]>=1.18.0,<2.0", "django-dramatiq>=0.14.0,<1.0", "pyTelegramBotAPI>=4.28.0,<5.0", "coolname>=2.2.0,<3.0", "django-admin-rangefilter>=0.13.0,<1.0", "python-json-logger>=3.3.0,<4.0", "requests>=2.32.0,<3.0", "tiktoken>=0.11.0,<1.0", "openai>=1.107.0,<2.0", "twilio>=9.8.0,<10.0", "sendgrid>=6.12.0,<7.0", "beautifulsoup4>=4.13.0,<5.0", "lxml>=6.0.0,<7.0", "pgvector>=0.4.0,<1.0", "tenacity>=9.1.2,<10.0.0", "mypy (>=1.18.2,<2.0.0)", "django-tailwind[reload] (>=4.2.0,<5.0.0)", "jinja2 (>=3.1.6,<4.0.0)", "django-axes[ipware] (>=8.0.0,<9.0.0)", "pydantic-settings (>=2.11.0,<3.0.0)",]

django_cfg/templates/admin/index.html

@@ -79,7 +79,27 @@
 {% block content %}
     <!-- Main Container -->
     {% component "unfold/components/container.html" %}
-        <div x-data="{ activeTab: 'builtin' }">
+        <div x-data="{
+            activeTab: 'builtin',
+            previousTab: 'builtin',
+            switchTab(tab) {
+                if (this.previousTab !== tab) {
+                    // Reset iframe to initial URL when switching tabs
+                    this.resetIframe(this.previousTab);
+                    this.previousTab = tab;
+                }
+                this.activeTab = tab;
+            },
+            resetIframe(tab) {
+                // Reset the iframe that was just hidden
+                const iframeId = tab === 'builtin' ? 'nextjs-dashboard-iframe-builtin' : 'nextjs-dashboard-iframe-nextjs';
+                const iframe = document.getElementById(iframeId);
+                if (iframe) {
+                    const originalSrc = iframe.getAttribute('data-original-src') || iframe.src;
+                    iframe.src = originalSrc;
+                }
+            }
+        }">
             {% if is_frontend_dev_mode %}
             <!-- Development Mode Badge -->
             <div class="bg-yellow-100 dark:bg-yellow-900 border-l-4 border-yellow-500 text-yellow-700 dark:text-yellow-300 p-4 mb-4" role="alert">
@@ -106,7 +126,7 @@
                         }
                     </style>
                     <nav class="-mb-px flex space-x-8 px-4" aria-label="Dashboard Tabs">
-                        <button @click="activeTab = 'builtin'"
+                        <button @click="switchTab('builtin')"
                                 class="whitespace-nowrap py-4 px-2 border-b-2 font-medium text-sm flex items-center gap-2 transition-all duration-200"
                                 :class="activeTab === 'builtin'
                                     ? 'border-primary-600 text-primary-600 dark:border-primary-500 dark:text-primary-500'
@@ -115,7 +135,7 @@
                             <span>Built-in Dashboard</span>
                         </button>
 
-                        <button @click="activeTab = 'nextjs'"
+                        <button @click="switchTab('nextjs')"
                                 class="whitespace-nowrap py-4 px-2 border-b-2 font-medium text-sm flex items-center gap-2 transition-all duration-200"
                                 :class="activeTab === 'nextjs'
                                     ? 'border-primary-600 text-primary-600 dark:border-primary-500 dark:text-primary-500'
@@ -140,6 +160,7 @@
                         id="nextjs-dashboard-iframe-builtin"
                         class="nextjs-dashboard-iframe"
                         src="{% nextjs_admin_url %}"
+                        data-original-src="{% nextjs_admin_url %}"
                         title="Next.js Dashboard"
                         sandbox="allow-same-origin allow-scripts allow-forms allow-popups allow-modals allow-storage-access-by-user-activation"
                         scrolling="no"
@@ -160,6 +181,7 @@
                         id="nextjs-dashboard-iframe-nextjs"
                         class="nextjs-dashboard-iframe nextjs-external-iframe"
                         src="{% nextjs_external_admin_url %}"
+                        data-original-src="{% nextjs_external_admin_url %}"
                         title="{% nextjs_external_admin_title %}"
                         sandbox="allow-same-origin allow-scripts allow-forms allow-popups allow-modals allow-storage-access-by-user-activation"
                         scrolling="no"
@@ -225,22 +247,62 @@
 
                 // Debounce timer for resize events (prevents jittery iframe height changes)
                 let resizeTimer = null;
+                let loadTimeout = null;
 
                 // iframe load event
                 iframe.addEventListener('load', function() {
+                    // Clear the fallback timeout
+                    if (loadTimeout) {
+                        clearTimeout(loadTimeout);
+                        loadTimeout = null;
+                    }
+
                     setTimeout(() => {
                         sendDataToIframe();
                     }, 100);
                 });
 
-                // Fallback: Show iframe after 5 seconds
-                setTimeout(() => {
-                    if (!iframe.classList.contains('loaded')) {
+                // iframe error event - fallback to static files
+                iframe.addEventListener('error', function() {
+                    console.warn('[Django-CFG] iframe failed to load, falling back to static files');
+                    handleLoadFailure();
+                });
+
+                // Timeout fallback - if iframe doesn't load in 3 seconds
+                loadTimeout = setTimeout(() => {
+                    if (!iframe.classList.contains('loaded') && isDevMode) {
+                        console.warn('[Django-CFG] Dev server timeout, falling back to static files');
+                        handleLoadFailure();
+                    } else if (!iframe.classList.contains('loaded')) {
                         console.log('[Django-CFG] Timeout - showing iframe anyway');
                         if (loading) loading.classList.add('hidden');
                         iframe.classList.add('loaded');
                     }
-                }, 5000);
+                }, 3000);
+
+                // Handle load failure - switch to static files
+                function handleLoadFailure() {
+                    if (!isDevMode) return; // Already using static files
+
+                    const originalSrc = iframe.getAttribute('data-original-src');
+                    if (!originalSrc) return;
+
+                    // Extract path from dev server URL
+                    const devUrl = new URL(originalSrc);
+                    const pathPart = devUrl.pathname.replace('/admin', '').replace(/^\//, '');
+
+                    // Build static files URL
+                    const staticUrl = `/cfg/admin/admin/${pathPart}`;
+
+                    console.log('[Django-CFG] Switching to static files:', staticUrl);
+                    iframe.src = staticUrl;
+
+                    // Show iframe after switching
+                    setTimeout(() => {
+                        if (loading) loading.classList.add('hidden');
+                        iframe.classList.add('loaded');
+                    }, 500);
+                }
 
                 // Send theme and auth data to iframe
                 function sendDataToIframe() {

django_cfg/templatetags/django_cfg.py

@@ -170,11 +170,10 @@ def nextjs_admin_url(path=''):
     Get the URL for Next.js Admin Panel (Built-in Dashboard - Tab 1).
 
     Auto-detects development mode with priority:
-        1. If port 3000 is available → use static files (Tab 2 gets dev server)
-        2. If only port 3001 is available → http://localhost:3001/admin/{path}
-        3. Otherwise → /cfg/admin/admin/{path} (static files)
+        1. If port 3001 is available → http://localhost:3001/admin/{path} (dev server)
+        2. Otherwise → /cfg/admin/admin/{path} (static files)
 
-    This ensures only ONE tab shows dev server at a time.
+    Note: Port 3000 is reserved for external Next.js admin (Tab 2).
 
     Usage in template:
         {% load django_cfg %}
@@ -188,20 +187,15 @@ def nextjs_admin_url(path=''):
         # Production mode: always use static files
         return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
 
-    # Check which ports are available
-    port_3000_available = _is_port_available('localhost', 3000)
+    # Check if port 3001 is available for Tab 1 (built-in admin)
     port_3001_available = _is_port_available('localhost', 3001)
 
-    # Priority: if port 3000 is running, Tab 2 gets it, Tab 1 uses static
-    if port_3000_available:
-        # Solution project is running - use static files for Tab 1
-        return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
-    elif port_3001_available:
-        # Dev project is running - use dev server for Tab 1
+    if port_3001_available:
+        # Dev server is running on 3001 - use it
         base_url = 'http://localhost:3001/admin'
         return f'{base_url}/{path}' if path else base_url
     else:
-        # No dev server - use static files
+        # No dev server or dev server stopped - use static files
         return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
 
 

{django_cfg-1.4.92.dist-info → django_cfg-1.4.94.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.92
-Summary: Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django.
+Version: 1.4.94
+Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com
 Project-URL: Repository, https://github.com/markolofsen/django-cfg
@@ -11,7 +11,7 @@ Author-email: Django-CFG Team <info@djangocfg.com>
 Maintainer-email: Django-CFG Team <info@djangocfg.com>
 License: MIT
 License-File: LICENSE
-Keywords: ai-agents,configuration,django,django-environ,django-settings,enterprise-django,ide-autocomplete,pydantic,pydantic-settings,settings,startup-validation,type-safe-config,type-safety
+Keywords: ai-agents,centrifugo,configuration,django,django-environ,django-settings,enterprise-django,ide-autocomplete,modern-django,nextjs-admin,pydantic,pydantic-settings,react-admin,real-time,settings,startup-validation,type-safe-config,type-safety,typescript-generation,websocket
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Django
 Classifier: Framework :: Django :: 5.2
@@ -148,7 +148,7 @@ Requires-Dist: pytest-xdist<4.0,>=3.8; extra == 'test'
 Requires-Dist: pytest<9.0,>=8.4; extra == 'test'
 Description-Content-Type: text/markdown
 
-# Django-CFG: Type-Safe Django Configuration Framework with AI-Ready Infrastructure
+# Django-CFG: Type-Safe Django Configuration Framework
 
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg?style=flat-square&logo=python)](https://www.python.org/downloads/)
 [![Django 5.2+](https://img.shields.io/badge/django-5.2+-green.svg?style=flat-square&logo=django)](https://www.djangoproject.com/)
@@ -165,119 +165,86 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-### 🚀 Pydantic Django Settings: Reduce Django Configuration Code by 90%
+### 🚀 The Modern Django Framework for Enterprise Applications
 
-**Type-safe Django configuration with Pydantic v2 models** • **Full IDE autocomplete** • **Startup validation** • **8 enterprise apps**
+**Type-safe configuration** • **Next.js Admin** • **AI Agents** • **Real-time WebSockets** • **8 Enterprise Apps**
 
-**[🤖 AI Project Generator](https://editor.djangocfg.com)** • **[🎯 Live Demo](http://demo.djangocfg.com)** • **[📚 Documentation](https://djangocfg.com/docs/getting-started/intro)**
+**[🎯 Live Demo](http://demo.djangocfg.com)** • **[📚 Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[🐙 GitHub](https://github.com/markolofsen/django-cfg)**
 
 </div>
 
-## 🤖 AI Project Generator - Zero Setup Required
-
-**Describe your app in plain English, get production-ready Django project in 30 seconds:**
-
-> *"I need a SaaS app with user authentication, Stripe payments, and admin dashboard"*
-
-**AI generates:** ✅ Type-safe config • ✅ Database models • ✅ REST API + docs • ✅ Modern UI • ✅ Deployment ready
-
-### **[→ Try AI Editor Now](https://editor.djangocfg.com)**
-
 ---
 
-## 🎯 Type-Safe Django Configuration with Pydantic v2
+## 🎯 What is Django-CFG?
 
-**Django-CFG replaces error-prone `settings.py` with type-safe Pydantic models** - eliminate runtime configuration errors, get full IDE autocomplete, and validate settings at startup. The only Django configuration framework with built-in AI agents and enterprise apps.
+**Django-CFG** is a next-generation Django framework that replaces traditional `settings.py` with **type-safe Pydantic v2 models**. It eliminates runtime configuration errors, provides complete IDE autocomplete, and includes **production-ready enterprise features** out of the box.
 
-### Why Type-Safe Configuration Matters
+### Why Django-CFG?
 
-**Traditional Django settings.py problems:**
-- ❌ **Runtime errors** - typos caught in production, not at startup
-- ❌ **No IDE support** - zero autocomplete, manual docs lookup
-- ❌ **200+ lines** - unmaintainable configuration sprawl
-- ❌ **Manual validation** - environment variables unchecked until used
+**Traditional Django problems:**
+- ❌ **Runtime errors** - configuration bugs discovered in production
+- ❌ **No IDE support** - zero autocomplete, manual documentation lookup
+- ❌ **200+ lines** of unmaintainable settings.py
+- ❌ **Weeks of setup** - for user auth, admin UI, payments, real-time features
 
-**Django-CFG Pydantic solution:**
-- ✅ **Compile-time validation** - catch errors before deployment
-- ✅ **Full IDE autocomplete** - IntelliSense for all settings
+**Django-CFG solution:**
+- ✅ **Startup validation** - catch all config errors before deployment
+- ✅ **Full IDE autocomplete** - IntelliSense for every setting
 - ✅ **30 lines of code** - 90% boilerplate reduction
-- ✅ **Startup validation** - fail fast with clear error messages
+- ✅ **30 seconds to production** - everything included and ready
 
-### Django Configuration Comparison
-
-| Feature | settings.py | django-environ | pydantic-settings | **Django-CFG** |
-|---------|-------------|----------------|-------------------|----------------|
-| **Type Safety** | ❌ Runtime only | ⚠️ Basic casting | ✅ Pydantic | ✅ **Full Pydantic v2** |
-| **IDE Autocomplete** | ❌ None | ❌ None | ⚠️ Partial | ✅ **100%** |
-| **Startup Validation** | ❌ No | ⚠️ Partial | ✅ Yes | ✅ **Yes + Custom validators** |
-| **Django Integration** | ✅ Native | ⚠️ Partial | ❌ Manual | ✅ **Seamless** |
-| **Built-in Apps** | ❌ Build yourself | ❌ None | ❌ None | ✅ **8 enterprise apps** |
-| **AI-Ready** | ❌ Manual setup | ❌ None | ❌ None | ✅ **LLM + Vector DB** |
-
-**[📚 Full comparison guide →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
+**[📚 Read the full comparison →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
 
 ---
 
-## 🚀 Three Ways to Start
-
-### Option 1: AI Editor (Fastest - 30 seconds) ⚡
-
-**Generate project with AI - no installation needed:**
+## 🚀 Quick Start
 
-1. Go to **[editor.djangocfg.com](https://editor.djangocfg.com)**
-2. Describe your app in plain English
-3. Download ready-to-deploy project
-
-**[→ Generate with AI](https://editor.djangocfg.com)**
-
----
-
-### Option 2: Traditional CLI
+### Installation
 
 ```bash
 pip install django-cfg
-django-cfg create-project "My SaaS App"
-cd my-saas-app && python manage.py runserver
+django-cfg create-project "My App"
+cd my-app && python manage.py runserver
 ```
 
 **What you get instantly:**
-- 🎨 Modern Admin UI → `http://127.0.0.1:8000/admin/`
-- 📚 API Docs → `http://127.0.0.1:8000/api/docs/`
-- 🚀 Production-ready app
+- 🎨 **Modern Admin UI** → `http://127.0.0.1:8000/admin/`
+- ⚡ **Next.js Dashboard** (optional) → Modern React admin interface
+- 📡 **Real-time WebSockets** → Live updates with Centrifugo
+- 🚀 **Production-ready** → Type-safe config, security hardened
 
 <div align="center">
 <img src="https://raw.githubusercontent.com/markolofsen/django-cfg/refs/heads/main/static/startup.png" alt="Django-CFG Startup Screen" width="800">
-<p><em>Django-CFG startup screen showing type-safe configuration validation</em></p>
+<p><em>Django-CFG startup with type-safe configuration validation</em></p>
 </div>
 
 **[📚 Installation Guide →](https://djangocfg.com/docs/getting-started/installation)**
 
 ---
 
-### Option 3: Explore Live Demo First 🎯
+### Try Live Demo
 
-**See a real production Django-CFG app in action:**
+**See Django-CFG in action:**
 
-### **[→ http://demo.djangocfg.com](http://demo.djangocfg.com)**
+**[→ http://demo.djangocfg.com](http://demo.djangocfg.com)**
 
 **Demo credentials:**
 - **Admin:** `demo@djangocfg.com` / `demo2024`
 - **User:** `user@djangocfg.com` / `user2024`
 
-**What you'll see:** Modern admin • Auto-generated API docs • AI agents • Support system • Payments
+**Explore:** Modern admin • Next.js dashboard • AI agents • Real-time updates • Support system
 
 ---
 
 ## 💡 Core Features
 
-### 🔒 Type-Safe Django Settings with Pydantic v2 Models
-
-**Replace Django's settings.py with Pydantic v2 for complete type safety, IDE autocomplete, and startup validation.**
+### 🔒 Type-Safe Configuration with Pydantic v2
 
-#### Before: Django settings.py (Runtime Errors)
+**Replace error-prone settings.py with validated Pydantic models.**
 
+#### Before: Django settings.py
 ```python
-# settings.py - No type checking, runtime errors
+# settings.py - Runtime errors, no validation
 import os
 
 DEBUG = os.getenv('DEBUG', 'False') == 'True'  # ❌ String comparison bug
@@ -290,98 +257,164 @@ DATABASES = {
         'PORT': DATABASE_PORT,          # ❌ Type mismatch in production
     }
 }
-# ... 200+ more lines of unvalidated configuration
+# ... 200+ more lines
 ```
 
-#### After: Django-CFG (Type-Safe Pydantic Configuration)
-
+#### After: Django-CFG
 ```python
-# config.py - Type-safe Pydantic Django settings
-from django_cfg import DjangoConfig
-from django_cfg.models import DatabaseConfig
+# config.py - Type-safe, validated at startup
+from django_cfg import DjangoConfig, DatabaseConfig
 
 class MyConfig(DjangoConfig):
-    """Production-grade type-safe Django configuration"""
+    """Production-ready type-safe configuration"""
 
-    project_name: str = "My SaaS App"
-    debug: bool = False  # ✅ Pydantic validates boolean conversion
+    project_name: str = "My App"
+    debug: bool = False  # ✅ Pydantic validates boolean
 
-    # Type-safe database configuration with startup validation
+    # Type-safe database with startup validation
     databases: dict[str, DatabaseConfig] = {
         "default": DatabaseConfig(
-            name="${DB_NAME}",     # ✅ Validated at startup
-            port=5432,             # ✅ Type-checked integer
+            name="${DB_NAME}",  # ✅ Validated at startup
+            port=5432,          # ✅ Type-checked integer
         )
     }
 ```
 
-**Django Configuration Benefits:**
-- ✅ **Pydantic v2 validation** - catch config errors before deployment
-- ✅ **Full IDE autocomplete** - IntelliSense for all Django settings
-- ✅ **90% less code** - reduce 200+ lines to 30 lines
-- ✅ **Type hints everywhere** - mypy and pyright compatible
+**Benefits:**
+- ✅ **Pydantic v2 validation** - catch errors before deployment
+- ✅ **Full IDE autocomplete** - IntelliSense everywhere
+- ✅ **90% less code** - 200+ lines → 30 lines
+- ✅ **Type hints** - mypy and pyright compatible
+
+**[📚 Type-safe configuration guide →](https://djangocfg.com/docs/fundamentals/core/type-safety)**
+
+---
+
+### ⚛️ Next.js Admin Integration
+
+**Build modern admin interfaces with React** - the only Django framework with built-in Next.js integration.
+
+```python
+from django_cfg import DjangoConfig, NextJsAdminConfig
+
+class MyConfig(DjangoConfig):
+    # One line for complete Next.js admin!
+    nextjs_admin: NextJsAdminConfig = NextJsAdminConfig(
+        project_path="../admin",
+    )
+```
+
+**What you get:**
+- 🌐 **Three-in-One Architecture** - Public site + User dashboard + Admin panel in ONE Next.js project
+- ⚙️ **Dual Admin Strategy** - Django Unfold (90% quick CRUD) + Next.js (10% complex features)
+- ✨ **Zero Configuration** - Auto JWT auth, theme sync, TypeScript generation
+- 📦 **60% Smaller** - ZIP deployment (~7MB vs ~20MB)
+- ⚡ **Auto-Detection** - Dev mode automatically detected on ports 3000/3001
+
+**No migration needed** - start with built-in admin, add Next.js when you need complex features!
 
-**[📚 Type-safe configuration guide →](https://djangocfg.com/docs/getting-started/configuration)**
+**[📚 Next.js Admin Documentation →](https://djangocfg.com/docs/features/integrations/nextjs-admin)**
 
 ---
 
-### 🤖 AI Django Framework - Production-Ready AI Agents
+### 📡 Real-Time WebSockets with Centrifugo
 
-**Django AI integration made simple** - type-safe AI agents, LLM workflow automation, and vector database built into Django.
+**Production-ready WebSocket integration** - live updates, notifications, and real-time collaboration.
+
+```python
+from django_cfg import DjangoConfig, CentrifugoConfig
+
+class MyConfig(DjangoConfig):
+    # Enable real-time features
+    centrifugo: CentrifugoConfig = CentrifugoConfig(
+        enabled=True,
+        api_url="http://localhost:8001/api",
+    )
+```
+
+**Built-in features:**
+- ⚡ **Live Updates** - Real-time data synchronization
+- 🔔 **Notifications** - Push notifications to connected clients
+- 👥 **Presence** - Track online users
+- 💬 **Chat** - Real-time messaging out of the box
+- 🔒 **JWT Auth** - Secure WebSocket connections
+
+**[📚 Centrifugo Integration Guide →](https://djangocfg.com/docs/features/integrations/centrifugo)**
+
+---
+
+### 🤖 AI-Ready Infrastructure
+
+**Built-in AI agent framework** - LLM workflow automation with Django ORM integration.
 
 ```python
 from django_cfg import DjangoConfig
 
 class MyConfig(DjangoConfig):
-    # AI-powered Django development - zero setup
+    # AI features (optional)
     openai_api_key: str = "${OPENAI_API_KEY}"
     anthropic_api_key: str = "${ANTHROPIC_API_KEY}"
 
-    # Enable AI Django agents (optional)
-    enable_agents: bool = True        # AI workflow automation
-    enable_knowbase: bool = True      # Vector database + RAG
+    enable_agents: bool = True      # AI workflow automation
+    enable_knowbase: bool = True    # Vector DB + RAG
 ```
 
-**Django AI Features:**
-- 🤖 **AI Agents Framework** - Type-safe Django LLM integration
-- 📚 **Vector Database** - ChromaDB semantic search for Django
-- 🔍 **RAG Integration** - Retrieval-augmented generation built-in
-- 🎯 **Pydantic AI** - Type-safe AI input/output validation
-- 🌐 **Multi-LLM** - OpenAI, Anthropic, Claude API support
+**Features:**
+- 🤖 **AI Agents Framework** - Type-safe LLM integration
+- 📚 **Vector Database** - ChromaDB for semantic search
+- 🔍 **RAG** - Retrieval-augmented generation
+- 🎯 **Pydantic AI** - Validated AI input/output
+- 🌐 **Multi-LLM** - OpenAI, Anthropic, Claude support
 
-**[📚 Django AI agents guide →](https://djangocfg.com/docs/ai-agents/introduction)**
+**[📚 AI Agents Guide →](https://djangocfg.com/docs/ai-agents/introduction)**
 
 ---
 
-### 📦 8 Production-Ready Enterprise Apps
+### 📦 8 Enterprise Apps Included
 
-**Ship features in days, not months** - everything you need is included:
+**Ship features in days, not months** - production-ready apps out of the box:
 
-- **👤 Accounts** - User management + OTP + SMS auth
-- **🎫 Support** - Ticketing system + SLA tracking
-- **📧 Newsletter** - Email campaigns + analytics
-- **📊 Leads** - CRM + sales pipeline
-- **🤖 AI Agents** - Optional workflow automation
-- **📚 KnowBase** - Optional AI knowledge base + RAG
-- **💳 Payments** - Multi-provider crypto/fiat payments
-- **🔧 Maintenance** - Multi-site Cloudflare management
+| App | Description | Time Saved |
+|-----|-------------|------------|
+| 👤 **Accounts** | User management + OTP + SMS auth | 3-4 weeks |
+| 🎫 **Support** | Ticketing system + SLA tracking | 2-3 weeks |
+| 📧 **Newsletter** | Email campaigns + analytics | 2-3 weeks |
+| 📊 **Leads** | CRM + sales pipeline | 2-3 weeks |
+| 🤖 **AI Agents** | Workflow automation | 3-4 weeks |
+| 📚 **KnowBase** | AI knowledge base + RAG | 2-3 weeks |
+| 💳 **Payments** | Multi-provider payments | 2-3 weeks |
+| 🔧 **Maintenance** | Multi-site management | 1-2 weeks |
 
-**Total time saved: 18 months of development**
+**Total time saved: 18+ months of development**
 
-**[📚 Explore all apps →](https://djangocfg.com/docs/features/built-in-apps)**
+```python
+class MyConfig(DjangoConfig):
+    # Enable apps as needed (one line each!)
+    enable_accounts: bool = True
+    enable_support: bool = True
+    enable_newsletter: bool = True
+    enable_leads: bool = True
+    enable_agents: bool = True
+    enable_knowbase: bool = True
+    enable_payments: bool = True
+    enable_maintenance: bool = True
+```
+
+**[📚 Built-in Apps Overview →](https://djangocfg.com/docs/features/built-in-apps/overview)**
 
 ---
 
 ### 🎨 Modern API UI with Tailwind 4
 
-**Beautiful browsable API** - 88% smaller bundle, 66% faster than old DRF UI.
+**Beautiful browsable API** - 88% smaller bundle, modern design.
 
 - ✅ Glass morphism design
 - ✅ Light/Dark/Auto themes
 - ✅ Command palette (⌘K)
-- ✅ 88% smaller bundle (278KB → 33KB)
+- ✅ 88% smaller (278KB → 33KB)
+- ✅ Auto-generated TypeScript clients
 
-**[📚 See API Theme →](https://djangocfg.com/docs/features/api-generation)**
+**[📚 API Generation Guide →](https://djangocfg.com/docs/features/api-generation/overview)**
 
 ---
 
@@ -390,43 +423,58 @@ class MyConfig(DjangoConfig):
 **Zero-config database routing** with automatic sharding:
 
 ```python
-databases: dict[str, DatabaseConfig] = {
-    "analytics": DatabaseConfig(
-        name="${ANALYTICS_DB}",
-        routing_apps=["analytics", "reports"],  # Auto-route!
-    ),
-}
+from django_cfg import DjangoConfig, DatabaseConfig
+
+class MyConfig(DjangoConfig):
+    databases: dict[str, DatabaseConfig] = {
+        "default": DatabaseConfig(
+            name="${DB_NAME}",
+        ),
+        "analytics": DatabaseConfig(
+            name="${ANALYTICS_DB}",
+            routing_apps=["analytics", "reports"],  # Auto-route!
+        ),
+    }
 ```
 
 ✅ Auto-routes read/write • ✅ Cross-DB transactions • ✅ Connection pooling
 
-**[📚 Multi-DB Guide →](https://djangocfg.com/docs/fundamentals/database)**
+**[📚 Multi-Database Guide →](https://djangocfg.com/docs/fundamentals/database/multi-database)**
 
 ---
 
 ## ⚙️ Complete Configuration Example
 
-**All available apps and integrations in one DjangoConfig:**
+**All features in one DjangoConfig:**
 
 ```python
-from django_cfg import DjangoConfig
-from django_cfg.models import DatabaseConfig, CacheConfig
+from django_cfg import DjangoConfig, DatabaseConfig, CacheConfig, NextJsAdminConfig
 
 class ProductionConfig(DjangoConfig):
-    # Project settings
+    # Project
     project_name: str = "My Enterprise App"
     secret_key: str = "${SECRET_KEY}"
     debug: bool = False
 
-    # 8 Built-in Enterprise Apps (enable as needed)
-    enable_accounts: bool = True      # 👤 User management + OTP + SMS
-    enable_support: bool = True       # 🎫 Ticketing + SLA tracking
-    enable_newsletter: bool = True    # 📧 Email campaigns
-    enable_leads: bool = True         # 📊 CRM + sales pipeline
-    enable_agents: bool = True        # 🤖 AI workflow automation
-    enable_knowbase: bool = True      # 📚 AI knowledge base + RAG
-    enable_payments: bool = True      # 💳 Crypto/fiat payments
-    enable_maintenance: bool = True   # 🔧 Cloudflare management
+    # Next.js Admin (optional)
+    nextjs_admin: NextJsAdminConfig = NextJsAdminConfig(
+        project_path="../admin",
+    )
+
+    # Real-time WebSockets (optional)
+    centrifugo: CentrifugoConfig = CentrifugoConfig(
+        enabled=True,
+    )
+
+    # 8 Enterprise Apps (enable as needed)
+    enable_accounts: bool = True      # User management
+    enable_support: bool = True       # Ticketing
+    enable_newsletter: bool = True    # Email campaigns
+    enable_leads: bool = True         # CRM
+    enable_agents: bool = True        # AI automation
+    enable_knowbase: bool = True      # Vector DB
+    enable_payments: bool = True      # Payments
+    enable_maintenance: bool = True   # Site management
 
     # Infrastructure
     databases: dict[str, DatabaseConfig] = {
@@ -440,75 +488,84 @@ class ProductionConfig(DjangoConfig):
     openai_api_key: str = "${OPENAI_API_KEY}"
     anthropic_api_key: str = "${ANTHROPIC_API_KEY}"
 
-    # Third-party Integrations
-    twilio_account_sid: str = "${TWILIO_ACCOUNT_SID}"  # SMS
-    stripe_api_key: str = "${STRIPE_API_KEY}"          # Payments
-    cloudflare_api_token: str = "${CF_API_TOKEN}"      # CDN/DNS
+    # Integrations
+    twilio_account_sid: str = "${TWILIO_ACCOUNT_SID}"
+    stripe_api_key: str = "${STRIPE_API_KEY}"
+    cloudflare_api_token: str = "${CF_API_TOKEN}"
 ```
 
-**[📚 Full configuration reference →](https://djangocfg.com/docs/getting-started/configuration)**
+**[📚 Configuration Reference →](https://djangocfg.com/docs/getting-started/configuration)**
 
 ---
 
-## 📊 Django Configuration Framework Comparison
+## 📊 Comparison with Alternatives
 
-**Django-CFG vs Traditional Django, DRF, FastAPI, and django-environ:**
+### Django-CFG vs Traditional Solutions
 
-| Feature | Django settings.py | django-environ | DRF | FastAPI | **Django-CFG** |
-|---------|-------------------|----------------|-----|---------|----------------|
-| **Type-Safe Config** | ❌ Runtime | ⚠️ Basic | ❌ Manual | ✅ Pydantic | ✅ **Full Pydantic v2** |
-| **IDE Autocomplete** | ❌ None | ❌ None | ❌ Manual | ⚠️ Partial | ✅ **100% IntelliSense** |
-| **Startup Validation** | ❌ No | ⚠️ Partial | ❌ No | ✅ Yes | ✅ **Pydantic + Custom** |
-| **Django Integration** | ✅ Native | ✅ Native | ✅ Native | ❌ Manual | ✅ **Seamless** |
-| **Admin UI** | 🟡 Basic | 🟡 Basic | 🟡 Basic | ❌ None | ✅ **Modern Unfold** |
-| **API Docs** | ❌ Manual | ❌ Manual | 🟡 Basic | ✅ Auto | ✅ **OpenAPI + Swagger** |
-| **AI Agents Built-in** | ❌ Manual | ❌ None | ❌ Manual | ❌ Manual | ✅ **LLM Framework** |
-| **Setup Time** | 🟡 Weeks | 🟡 Hours | 🟡 Weeks | 🟡 Days | ✅ **30 seconds** |
-| **Enterprise Apps** | ❌ Build all | ❌ None | ❌ Build all | ❌ Build all | ✅ **8 included** |
-| **Configuration Lines** | ⚠️ 200+ | ⚠️ 150+ | ⚠️ 200+ | ⚠️ 100+ | ✅ **30 lines** |
+| Feature | settings.py | django-environ | pydantic-settings | **Django-CFG** |
+|---------|-------------|----------------|-------------------|----------------|
+| **Type Safety** | ❌ Runtime | ⚠️ Basic | ✅ Pydantic | ✅ **Full Pydantic v2** |
+| **IDE Autocomplete** | ❌ None | ❌ None | ⚠️ Partial | ✅ **100%** |
+| **Startup Validation** | ❌ No | ⚠️ Partial | ✅ Yes | ✅ **Yes + Custom** |
+| **Next.js Admin** | ❌ Manual | ❌ None | ❌ None | ✅ **Built-in** |
+| **WebSocket (Centrifugo)** | ❌ Manual | ❌ None | ❌ None | ✅ **Built-in** |
+| **Enterprise Apps** | ❌ Build all | ❌ None | ❌ None | ✅ **8 included** |
+| **AI Framework** | ❌ Manual | ❌ None | ❌ None | ✅ **Built-in** |
+| **Setup Time** | 🟡 Weeks | 🟡 Hours | 🟡 Days | ✅ **30 seconds** |
+| **Config Lines** | ⚠️ 200+ | ⚠️ 150+ | ⚠️ 100+ | ✅ **30 lines** |
 
 **Legend:** ✅ Excellent | 🟡 Requires Work | ⚠️ Partial | ❌ Not Available
 
-**[📚 Django-CFG vs django-environ detailed comparison →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
+**[📚 Detailed Comparison Guide →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
 
 ---
 
 ## 📚 Documentation
 
 ### 🚀 Getting Started
-- **[Installation](https://djangocfg.com/docs/getting-started/installation)** - Quick setup guide
+- **[Installation](https://djangocfg.com/docs/getting-started/installation)** - Quick setup
 - **[First Project](https://djangocfg.com/docs/getting-started/first-project)** - Create your first app
-- **[Configuration](https://djangocfg.com/docs/getting-started/configuration)** - Type-safe config guide
+- **[Configuration](https://djangocfg.com/docs/getting-started/configuration)** - Type-safe config
 - **[Why Django-CFG?](https://djangocfg.com/docs/getting-started/why-django-cfg)** - Full comparison
 
+### ⚛️ Next.js Integration
+- **[Overview](https://djangocfg.com/docs/features/integrations/nextjs-admin)** - Three-in-One architecture
+- **[Core Concepts](https://djangocfg.com/docs/features/integrations/nextjs-admin/concepts)** - Philosophy & design
+- **[Quick Start](https://djangocfg.com/docs/features/integrations/nextjs-admin/quick-start)** - 5-minute setup
+- **[Configuration](https://djangocfg.com/docs/features/integrations/nextjs-admin/configuration)** - All options
+
+### 📡 Real-Time Features
+- **[Centrifugo Integration](https://djangocfg.com/docs/features/integrations/centrifugo)** - WebSocket setup
+- **[Live Updates](https://djangocfg.com/docs/features/integrations/centrifugo/live-updates)** - Real-time data
+
 ### 🏗️ Core Features
-- **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps)** - 8 enterprise apps
-- **[API Generation](https://djangocfg.com/docs/features/api-generation)** - Auto OpenAPI docs
-- **[Database](https://djangocfg.com/docs/fundamentals/database)** - Multi-DB routing
-- **[Integrations](https://djangocfg.com/docs/features/integrations)** - Third-party services
+- **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps/overview)** - 8 enterprise apps
+- **[API Generation](https://djangocfg.com/docs/features/api-generation/overview)** - Auto TypeScript clients
+- **[Database](https://djangocfg.com/docs/fundamentals/database/multi-database)** - Multi-DB routing
+- **[Type Safety](https://djangocfg.com/docs/fundamentals/core/type-safety)** - Pydantic validation
 
-### 🤖 AI Integration (Optional)
+### 🤖 AI Features (Optional)
 - **[AI Agents](https://djangocfg.com/docs/ai-agents/introduction)** - Workflow automation
 - **[Creating Agents](https://djangocfg.com/docs/ai-agents/creating-agents)** - Build custom agents
-- **[Django Integration](https://djangocfg.com/docs/ai-agents/django-integration)** - Connect to your app
+- **[Django Integration](https://djangocfg.com/docs/ai-agents/django-integration)** - ORM integration
 
 ### 🚀 Deployment
-- **[Production Config](https://djangocfg.com/docs/deployment)** - Production best practices
-- **[CLI Commands](https://djangocfg.com/docs/cli)** - 50+ management commands
+- **[Production Config](https://djangocfg.com/docs/deployment)** - Best practices
+- **[CLI Commands](https://djangocfg.com/docs/cli)** - 50+ commands
 
 ---
 
 ## 🤝 Community & Support
 
 ### Resources
-- 🌐 **[djangocfg.com](https://djangocfg.com/)** - Official website & documentation
+- 🌐 **[djangocfg.com](https://djangocfg.com/)** - Official website & docs
 - 🐙 **[GitHub](https://github.com/markolofsen/django-cfg)** - Source code & issues
 - 💬 **[Discussions](https://github.com/markolofsen/django-cfg/discussions)** - Community support
 
 ### Links
-- **[🚀 AI Project Generator](https://editor.djangocfg.com)** - Generate projects with AI
 - **[🎯 Live Demo](http://demo.djangocfg.com)** - See it in action
 - **[📦 PyPI](https://pypi.org/project/django-cfg/)** - Package repository
+- **[📚 Documentation](https://djangocfg.com/docs)** - Complete guides
 
 ---
 
@@ -524,12 +581,12 @@ class ProductionConfig(DjangoConfig):
 
 <div align="center">
 
-**Django AI Framework** • **Type-Safe Configuration** • **Pydantic Settings** • **Enterprise Apps**
+**Modern Django Framework** • **Type-Safe Configuration** • **Next.js Admin** • **Real-Time WebSockets** • **AI-Ready**
 
-Django-CFG is the AI-first Django framework for production-ready AI agents, type-safe Pydantic v2 configuration, and enterprise development. Replace settings.py with validated models, build AI workflows with Django ORM integration, and ship faster with 8 built-in apps. Perfect for Django LLM integration, AI-powered Django development, scalable Django architecture, and reducing Django boilerplate.
+Django-CFG is the modern Django framework for enterprise applications. Built with Pydantic v2 for type-safe configuration, includes Next.js admin integration, Centrifugo WebSocket support, AI agent framework, and 8 production-ready apps. Perfect for building scalable Django applications with reduced boilerplate and enterprise features out of the box.
 
 ---
 
-**Get Started:** **[Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[AI Project Generator](https://editor.djangocfg.com)** • **[Live Demo](http://demo.djangocfg.com)**
+**Get Started:** **[Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[Live Demo](http://demo.djangocfg.com)** • **[GitHub](https://github.com/markolofsen/django-cfg)**
 
 </div>

{django_cfg-1.4.92.dist-info → django_cfg-1.4.94.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=pz7YbfETPVh0YKhFH8_iJUk4fnnsYc3GSgN4nzqt-cE,1620
+django_cfg/__init__.py,sha256=-eM13Z1Uie8EJUy2384SNHfso1SqzwpkDsmrQgWQN3w,1620
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=y4Z3rnYsHBE0TehpwAIPaxr---mkvyKrZGGsNwYso74,1398
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -228,7 +228,7 @@ django_cfg/apps/frontend/apps.py,sha256=9eEK0Tq2nOsol7xSK5aobdwTDJTJrWx6Iy1I1DQb
 django_cfg/apps/frontend/setup.py,sha256=TxKQwQw4xTF6VSyhrQBzbUsdsVQR9JHdjc36LZKeQh4,2444
 django_cfg/apps/frontend/test_routing.py,sha256=fshJOR9ln7m3gXY9EI1_ix_6E5xua6DR264b16RIF-w,4832
 django_cfg/apps/frontend/urls.py,sha256=Vz22_2i2w1J0KQYDCxHnTF5rUf32kUUSBDJZrP07XgY,284
-django_cfg/apps/frontend/views.py,sha256=dcdzrVZGIZ_IdlJJwQ4bpGw4x8V3GYGmv1Dc_xxXZIQ,10406
+django_cfg/apps/frontend/views.py,sha256=JkObFoAJATT2gy6TnyFi0LrjQm7HGWaRy3vr2zdTs4E,13586
 django_cfg/apps/frontend/templates/frontend/404.html,sha256=LCFig_dcgDDmYKhgOLu8R2KDs_aQS6Es6rAxLTAEXWs,2175
 django_cfg/apps/knowbase/README.md,sha256=HXt_J6WCN-LsMhA7p9mdvih07_vp_r_hkPdmqHhNEeo,3965
 django_cfg/apps/knowbase/__init__.py,sha256=cfGnxDQwjajPhUoleKkgvdabJcB0LdXEglnsBojKkPo,1045
@@ -1021,7 +1021,7 @@ django_cfg/modules/django_unfold/models/navigation.py,sha256=PPEeqA2HBaA1-VjADiX
 django_cfg/modules/nextjs_admin/__init__.py,sha256=lfrZYyNRExH3Z5De8G4hQBIZoFlW5Ejze3couNrztbY,312
 django_cfg/modules/nextjs_admin/apps.py,sha256=HxVUMmWTKdYpwJ00iIfWVFsBzsawsOVhEPZqjk_izjI,347
 django_cfg/modules/nextjs_admin/urls.py,sha256=7n0yStm0WNchw14Rtu_mgsIA3WKQsYP9WZt3-YOUWjU,603
-django_cfg/modules/nextjs_admin/views.py,sha256=SxpFQeRas0FsolZ4QNCqDEAVhncGxnDP4HtamuUsTu0,9655
+django_cfg/modules/nextjs_admin/views.py,sha256=lOcK-XLucWn-W4LORgk0XBEJkolYvSvsnp4Pq77oBBY,9657
 django_cfg/modules/nextjs_admin/models/__init__.py,sha256=WGw9KXcYd1O9AoA_bpMoz2gLZUlRzjGmUBjjbObcUi0,100
 django_cfg/modules/nextjs_admin/models/config.py,sha256=0ADqLuiywSCQfx_z9dkwjFCca3lr3F2uQffIjTr_QXw,5864
 django_cfg/modules/nextjs_admin/templatetags/__init__.py,sha256=ChVBnJggCIY8rMhfyJFoA8k0qKo-8FtJknrk54Vx4wM,51
@@ -1051,7 +1051,7 @@ django_cfg/static/admin/js/alpine/dashboard-tabs.js,sha256=ob8Q_I9lFLDv_hFERXgTy
 django_cfg/static/admin/js/alpine/system-metrics.js,sha256=m-Fg55K_vpHXToD46PXL9twl4OBF_V9MONvbSWbQqDw,440
 django_cfg/static/admin/js/alpine/toggle-section.js,sha256=T141NFmy0fRJyGGuuaCJRjJXwPam-xxtQNW1hi8BJbc,672
 django_cfg/static/frontend/admin.zip,sha256=n2G8ajruLqojcjqvw2pMEPjgpSTTwcmJxkeIQxJVw9U,7626768
-django_cfg/static/frontend/nextjs_admin.zip,sha256=KZMpJgmsL-Gx-la-zLCpV0W2pZ0X94IrPqNNK8fmGB0,7509389
+django_cfg/static/frontend/nextjs_admin.zip,sha256=BsnMjrr9vx1Lh1zadBEBFGeP-Cn_eLjhWfkWk1m0fEw,7548272
 django_cfg/static/js/api-loader.mjs,sha256=boGqqRGnFR-Mzo_RQOjhAzNvsb7QxZddSwMKROzkk9Q,5163
 django_cfg/static/js/api/base.mjs,sha256=KUxZHHdELAV8mNnACpwJRvaQhdJxp-n5LFEQ4oUZxBo,4707
 django_cfg/static/js/api/index.mjs,sha256=_-Q04jjHcgwi4CGfiaLyiOR6NW7Yu1HBhJWp2J1cjpc,2538
@@ -1073,11 +1073,11 @@ django_cfg/static/js/api/support/index.mjs,sha256=oPA3iGkUWYyKQuJlI5-tSxD3AOhwlA
 django_cfg/static/js/api/tasks/client.mjs,sha256=tIy8K-finXzTUL9kOo_L4Q1kchDaHyuzjwS4VymiWPM,3579
 django_cfg/static/js/api/tasks/index.mjs,sha256=yCY1GzdD-RtFZ3pAfk1l0msgO1epyo0lsGCjH0g1Afc,294
 django_cfg/templates/__init__.py,sha256=IzLjt-a7VIJ0OutmAE1_-w0_LpL2u0MgGpnIabjZuW8,19
-django_cfg/templates/admin/index.html,sha256=6-f3b2IfMkK_Qog5jHzeotqn3GAeLE7JpJIVoDA67L8,15302
+django_cfg/templates/admin/index.html,sha256=RidRvZwc6LFzRi8l6vHBgyM_CD0yvhPWvr40uVKCClY,18138
 django_cfg/templates/emails/base_email.html,sha256=TWcvYa2IHShlF_E8jf1bWZStRO0v8G4L_GexPxvz6XQ,8836
 django_cfg/templates/unfold/layouts/skeleton.html,sha256=2ArkcNZ34mFs30cOAsTQ1EZiDXcB0aVxkO71lJq9SLE,718
 django_cfg/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/templatetags/django_cfg.py,sha256=7lGod6_K8AonRAUIZksluN6SWoxqQjke67D-lllMpY8,9670
+django_cfg/templatetags/django_cfg.py,sha256=0m7YadW6ifWuUEA9qe9IZ6zY4wt4F4ke0RXo3ngA5p8,9334
 django_cfg/utils/__init__.py,sha256=64wwXJuXytvwt8Ze_erSR2HmV07nGWJ6DV5wloRBvYE,435
 django_cfg/utils/path_resolution.py,sha256=2n0I04lQkSssFaELu3A93YyMAl1K10KPdpxMt5k4Iy0,13341
 django_cfg/utils/smart_defaults.py,sha256=ZUj6K_Deq-fp5O0Dy_Emt257UWFn0f9bkgFv9YCR58U,9239
@@ -1085,9 +1085,9 @@ django_cfg/utils/version_check.py,sha256=WO51J2m2e-wVqWCRwbultEwu3q1lQasV67Mw2aa
 django_cfg/CHANGELOG.md,sha256=jtT3EprqEJkqSUh7IraP73vQ8PmKUMdRtznQsEnqDZk,2052
 django_cfg/CONTRIBUTING.md,sha256=DU2kyQ6PU0Z24ob7O_OqKWEYHcZmJDgzw-lQCmu6uBg,3041
 django_cfg/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg/pyproject.toml,sha256=HlcU42lQgCt8Qn4XJAjcIuIaU2X1wsjmzqMV-9G0fKI,8370
-django_cfg-1.4.92.dist-info/METADATA,sha256=CiXTzDGbsjBbZ7aDnUUNERfR1FR8Kz_VlV50BAOjUNM,22624
-django_cfg-1.4.92.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.92.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.92.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.92.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=J8hwDLhnybgAGUsvUNdXFimKoEuj7Lc9SH1n5f_Q0gY,8572
+django_cfg-1.4.94.dist-info/METADATA,sha256=Xhg1mauCgGfgGYkYBGmGWH19KcqlRxLi4z-kGAGFvVs,23733
+django_cfg-1.4.94.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.94.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.94.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.94.dist-info/RECORD,,