django-cfg 1.4.83__py3-none-any.whl → 1.4.85__py3-none-any.whl

django_cfg/templates/admin_old/sections/documentation_section.html

@@ -0,0 +1,152 @@
+{% load static %}
+<link rel="stylesheet" href="{% static 'admin/css/prose-unfold.css' %}">
+
+<!-- Documentation Section -->
+<div class="space-y-6" x-data="toggleSection()">
+    {% if error %}
+        <!-- Error State -->
+        <div class="bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-default p-6">
+            <div class="flex items-center space-x-2 text-red-600 dark:text-red-400">
+                <span class="material-symbols-outlined">error</span>
+                <span class="font-semibold">Error loading documentation</span>
+            </div>
+            <p class="mt-2 text-sm text-red-600 dark:text-red-400">{{ error }}</p>
+        </div>
+    {% elif commands_by_module %}
+        <!-- Commands by App -->
+        {% for app_key, app in commands_by_module.items %}
+            <div class="app-block bg-gradient-to-br from-white to-base-50 dark:from-base-800 dark:to-base-900 rounded-default shadow-md border border-base-200 dark:border-base-700 overflow-hidden mb-6">
+                <!-- App Header (Toggle) -->
+                <div @click="toggleSection('{{ app_key }}')"
+                     class="cursor-pointer select-none p-6 border-b border-base-200 dark:border-base-700 hover:bg-base-100/50 dark:hover:bg-base-900/30 transition-all duration-200"
+                     data-app="{{ app_key }}">
+                    <div class="w-full flex items-center justify-between">
+                        <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark flex items-center">
+                            <div class="w-10 h-10 rounded-lg bg-primary-100 dark:bg-primary-900/30 flex items-center justify-center mr-3">
+                                <span class="material-symbols-outlined text-primary-600 dark:text-primary-400">description</span>
+                            </div>
+                            <div>
+                                <div class="flex items-center gap-2">
+                                    {{ app.display_name }}
+                                    <span class="px-2 py-0.5 text-xs font-medium rounded-full bg-base-200 dark:bg-base-700 text-font-default-light dark:text-font-default-dark app-count">
+                                        {{ app.commands|length }}
+                                    </span>
+                                </div>
+                            </div>
+                        </h3>
+                        <span
+                            class="material-symbols-outlined text-base-400 dark:text-base-500 transition-transform duration-200 select-none"
+                            x-text="isSectionExpanded('{{ app_key }}') ? 'expand_less' : 'expand_more'"
+                        ></span>
+                    </div>
+                </div>
+
+                <!-- App Content -->
+                <div class="app-content bg-base-50/30 dark:bg-base-900/30 p-6 space-y-4"
+                     data-app="{{ app_key }}"
+                     x-show="isSectionExpanded('{{ app_key }}')"
+                     x-cloak>
+
+                    <!-- Commands List -->
+                    <div class="space-y-3">
+                        {% for command in app.commands %}
+                            <div class="documentation-card bg-white dark:bg-base-900 rounded-default border border-base-200/60 dark:border-base-700/60 p-4 hover:border-base-300 dark:hover:border-base-600 transition-all duration-200">
+                                <!-- Command Header -->
+                                <div class="flex items-start justify-between mb-3">
+                                    <div class="flex-1">
+                                        <div class="flex items-center flex-wrap gap-2 mb-2">
+                                            <code class="text-sm font-mono bg-base-100 dark:bg-base-800 px-2 py-1 rounded text-primary-600 dark:text-primary-400">
+                                                python manage.py {{ command.name }}
+                                            </code>
+                                            {% if command.is_destructive %}
+                                                <span class="text-xs bg-red-100 dark:bg-red-900/30 text-red-600 dark:text-red-400 px-2 py-0.5 rounded">
+                                                    Destructive
+                                                </span>
+                                            {% endif %}
+                                            {% if command.web_executable %}
+                                                <span class="text-xs bg-green-100 dark:bg-green-900/30 text-green-600 dark:text-green-400 px-2 py-0.5 rounded">
+                                                    Web Executable
+                                                </span>
+                                            {% endif %}
+                                        </div>
+                                        <p class="text-sm text-font-default-light dark:text-font-default-dark">
+                                            {{ command.help }}
+                                        </p>
+                                    </div>
+                                </div>
+
+                                <!-- Command Docstring -->
+                                {% if command.docstring %}
+                                    <div class="mt-3 prose prose-unfold max-w-none text-sm">
+                                        {{ command.docstring }}
+                                    </div>
+                                {% endif %}
+
+                                <!-- Arguments -->
+                                {% if command.arguments %}
+                                    <div class="mt-4 border-t border-base-200 dark:border-base-700 pt-3">
+                                        <h4 class="text-xs font-semibold text-font-important-light dark:text-font-important-dark uppercase mb-2">
+                                            Arguments
+                                        </h4>
+                                        <div class="space-y-2">
+                                            {% for arg in command.arguments %}
+                                                <div class="flex items-start space-x-2 text-sm">
+                                                    <code class="font-mono bg-base-100 dark:bg-base-800 px-2 py-0.5 rounded text-xs text-primary-600 dark:text-primary-400 whitespace-nowrap">
+                                                        {{ arg.options|join:", " }}
+                                                    </code>
+                                                    <div class="flex-1">
+                                                        <span class="text-font-default-light dark:text-font-default-dark">
+                                                            {{ arg.help }}
+                                                        </span>
+                                                        {% if arg.default %}
+                                                            <span class="text-font-subtle-light dark:text-font-subtle-dark text-xs">
+                                                                (default: {{ arg.default }})
+                                                            </span>
+                                                        {% endif %}
+                                                        {% if arg.required %}
+                                                            <span class="text-xs text-red-600 dark:text-red-400 ml-1">
+                                                                *required
+                                                            </span>
+                                                        {% endif %}
+                                                    </div>
+                                                </div>
+                                            {% endfor %}
+                                        </div>
+                                    </div>
+                                {% endif %}
+                            </div>
+                        {% endfor %}
+                    </div>
+                </div>
+            </div>
+        {% endfor %}
+
+        <!-- Summary Stats -->
+        <div class="bg-white dark:bg-base-800 rounded-default shadow-sm border border-base-200 dark:border-base-700 p-4 mt-6">
+            <div class="flex items-center justify-center gap-8 text-sm text-font-subtle-light dark:text-font-subtle-dark">
+                <div class="flex items-center gap-2">
+                    <span class="material-symbols-outlined text-base">folder</span>
+                    <span>{{ total_modules }} module{{ total_modules|pluralize }}</span>
+                </div>
+                <div class="flex items-center gap-2">
+                    <span class="material-symbols-outlined text-base">terminal</span>
+                    <span>{{ total_commands }} command{{ total_commands|pluralize }}</span>
+                </div>
+            </div>
+        </div>
+    {% else %}
+        <!-- Empty State -->
+        <div class="bg-base-50 dark:bg-base-800 rounded-default border border-base-200 dark:border-base-700 p-12 text-center">
+            <span class="material-symbols-outlined text-6xl text-base-400 dark:text-base-500 mb-4">inbox</span>
+            <h3 class="text-lg font-medium text-font-important-light dark:text-font-important-dark mb-2">
+                No Commands Found
+            </h3>
+            <p class="text-font-subtle-light dark:text-font-subtle-dark">
+                No Django-CFG management commands available.
+            </p>
+        </div>
+    {% endif %}
+</div>
+
+<!-- Load Alpine component -->
+<script src="{% static 'admin/js/alpine/toggle-section.js' %}"></script>

django_cfg/templates/admin_old/sections/overview_section.html

@@ -0,0 +1,112 @@
+{% load unfold %}
+
+<!-- Overview Section -->
+<div class="space-y-10 flex flex-col gap-8">
+    <!-- Hero Section with Key Metrics -->
+    <div>
+        <div class="flex items-center justify-between mb-6">
+            <div>
+                <h1 class="text-2xl font-bold theme-text">{{ title|default:"System Overview" }}</h1>
+                <p class="text-gray-600 dark:text-gray-300 mt-2">
+                    Real-time monitoring and key performance indicators
+                </p>
+            </div>
+            <div class="flex items-center space-x-2 text-sm text-gray-500 dark:text-gray-400">
+                <span class="material-icons text-green-500">fiber_manual_record</span>
+                <span>Live data</span>
+            </div>
+        </div>
+
+        <!-- Key Statistics Cards -->
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-6">
+            {% for key, value in data.stats.items %}
+                <div class="theme-card p-6 rounded-lg shadow-sm border theme-border">
+                    <div class="flex items-center justify-between">
+                        <div>
+                            <p class="text-sm text-gray-600 dark:text-gray-400 uppercase">{{ key }}</p>
+                            <p class="text-3xl font-bold theme-text mt-2">{{ value }}</p>
+                        </div>
+                        <span class="material-icons text-blue-500 text-4xl">{{ icon|default:"analytics" }}</span>
+                    </div>
+                </div>
+            {% endfor %}
+        </div>
+    </div>
+
+    <!-- System Health & Quick Actions -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-8 mb-8">
+        <div class="theme-card rounded-lg shadow-sm border theme-border">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-green-500 mr-2">favorite</span>
+                    System Health
+                </h3>
+            </div>
+            <div class="p-6">
+                <div class="space-y-4">
+                    {% for key, value in data.system_health.items %}
+                        <div class="flex items-center justify-between">
+                            <span class="text-gray-700 dark:text-gray-300">{{ key|title }}</span>
+                            <span class="font-mono text-sm theme-text">{{ value }}</span>
+                        </div>
+                    {% endfor %}
+                </div>
+            </div>
+        </div>
+
+        <!-- Quick Actions Card -->
+        <div class="theme-card rounded-lg border theme-border shadow-sm">
+            <div class="p-6">
+                {% include 'admin/snippets/components/quick_actions.html' %}
+            </div>
+        </div>
+    </div>
+
+    <!-- Charts & Recent Activity -->
+    <div class="space-y-8">
+        <!-- Charts Section -->
+        {% include 'admin/snippets/components/charts_section.html' %}
+
+        <!-- Recent Activity Stream -->
+        <div class="theme-card rounded-lg shadow-sm border theme-border">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-blue-600 mr-2">timeline</span>
+                    Recent Activity
+                </h3>
+            </div>
+            <div class="p-6">
+                {% include 'admin/snippets/components/recent_activity_improved.html' %}
+            </div>
+        </div>
+    </div>
+
+    <!-- Secondary Metrics Row -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
+        <!-- System Metrics -->
+        <div class="theme-card rounded-lg border theme-border shadow-sm">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-blue-500 mr-2">memory</span>
+                    System Metrics
+                </h3>
+            </div>
+            <div class="p-6">
+                {% include 'admin/snippets/components/system_metrics.html' %}
+            </div>
+        </div>
+
+        <!-- Activity Tracker -->
+        <div class="theme-card rounded-lg border theme-border shadow-sm">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-blue-600 mr-2">track_changes</span>
+                    Activity Tracker
+                </h3>
+            </div>
+            <div class="p-6">
+                {% include 'admin/snippets/components/activity_tracker.html' %}
+            </div>
+        </div>
+    </div>
+</div>

django_cfg/templates/admin_old/sections/stats_section.html

@@ -0,0 +1,35 @@
+{% load unfold %}
+
+<!-- Statistics Section -->
+<div class="space-y-8">
+    <div class="flex items-center justify-between mb-6">
+        <div>
+            <h1 class="text-2xl font-bold theme-text">{{ title|default:"Statistics" }}</h1>
+            <p class="text-gray-600 dark:text-gray-300 mt-2">
+                Detailed metrics for each application module
+            </p>
+        </div>
+    </div>
+
+    <!-- App Statistics -->
+    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+        {% for app in data.app_stats %}
+            <div class="theme-card p-6 rounded-lg shadow-sm border theme-border">
+                <div class="flex items-center justify-between mb-4">
+                    <h3 class="font-semibold theme-text">{{ app.name }}</h3>
+                    <span class="material-icons text-blue-500">{{ app.icon|default:"apps" }}</span>
+                </div>
+                <div class="space-y-2">
+                    <div class="flex justify-between text-sm">
+                        <span class="text-gray-600 dark:text-gray-400">Label:</span>
+                        <span class="theme-text">{{ app.label }}</span>
+                    </div>
+                    <div class="flex justify-between text-sm">
+                        <span class="text-gray-600 dark:text-gray-400">Models:</span>
+                        <span class="theme-text font-mono">{{ app.models_count }}</span>
+                    </div>
+                </div>
+            </div>
+        {% endfor %}
+    </div>
+</div>

django_cfg/templates/admin_old/sections/system_section.html

@@ -0,0 +1,99 @@
+{% load unfold %}
+
+<!-- System Management Section -->
+<div class="space-y-8">
+    <div class="flex items-center justify-between mb-6">
+        <div>
+            <h1 class="text-2xl font-bold theme-text">{{ title|default:"System Management" }}</h1>
+            <p class="text-gray-600 dark:text-gray-300 mt-2">
+                System health checks and configuration overview
+            </p>
+        </div>
+        <div class="flex items-center space-x-2">
+            {% if data.health.status == 'healthy' %}
+                <span class="material-icons text-green-500">check_circle</span>
+                <span class="text-sm text-green-600 dark:text-green-400 font-medium">Healthy</span>
+            {% else %}
+                <span class="material-icons text-red-500">error</span>
+                <span class="text-sm text-red-600 dark:text-red-400 font-medium">Issues Detected</span>
+            {% endif %}
+        </div>
+    </div>
+
+    <!-- Health Checks Grid -->
+    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 mb-8">
+        {% for check_name, check_status in data.health.checks.items %}
+            <div class="theme-card p-6 rounded-lg shadow-sm border theme-border">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-sm text-gray-600 dark:text-gray-400 uppercase">{{ check_name|title }}</p>
+                        <p class="text-lg font-semibold theme-text mt-2">
+                            {% if check_status %}
+                                <span class="text-green-600 dark:text-green-400">Operational</span>
+                            {% else %}
+                                <span class="text-red-600 dark:text-red-400">Failed</span>
+                            {% endif %}
+                        </p>
+                    </div>
+                    {% if check_status %}
+                        <span class="material-icons text-green-500 text-3xl">check_circle</span>
+                    {% else %}
+                        <span class="material-icons text-red-500 text-3xl">cancel</span>
+                    {% endif %}
+                </div>
+            </div>
+        {% endfor %}
+    </div>
+
+    <!-- Configuration & Services -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
+        <!-- Configuration Card -->
+        <div class="theme-card rounded-lg shadow-sm border theme-border">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-blue-500 mr-2">settings</span>
+                    Configuration
+                </h3>
+            </div>
+            <div class="p-6">
+                <div class="space-y-4">
+                    {% for key, value in data.configuration.items %}
+                        <div class="flex items-center justify-between">
+                            <span class="text-gray-700 dark:text-gray-300">{{ key|title }}</span>
+                            <span class="font-mono text-sm theme-text">{{ value }}</span>
+                        </div>
+                    {% endfor %}
+                </div>
+            </div>
+        </div>
+
+        <!-- Services Status Card -->
+        <div class="theme-card rounded-lg shadow-sm border theme-border">
+            <div class="p-6 border-b theme-border">
+                <h3 class="text-lg font-semibold theme-text flex items-center">
+                    <span class="material-icons text-purple-500 mr-2">cloud</span>
+                    Services
+                </h3>
+            </div>
+            <div class="p-6">
+                {% if data.services %}
+                    <div class="space-y-3">
+                        {% for service_name, service_status in data.services.items %}
+                            <div class="flex items-center justify-between text-sm">
+                                <span class="theme-text">{{ service_name }}</span>
+                                <div class="status-indicator">
+                                    <span class="status-dot {% if service_status %}success{% else %}error{% endif %}"></span>
+                                    <span class="text-gray-600 dark:text-gray-400">
+                                        {% if service_status %}Active{% else %}Inactive{% endif %}
+                                    </span>
+                                </div>
+                            </div>
+                        {% endfor %}
+                    </div>
+                {% else %}
+                    <p class="text-gray-500 dark:text-gray-400 text-sm">No external services configured</p>
+                {% endif %}
+            </div>
+        </div>
+    </div>
+</div>

django_cfg/templates/admin_old/sections/widgets_section.html

@@ -0,0 +1,129 @@
+{% load unfold %}
+
+<!-- Widgets Section -->
+<div class="space-y-8">
+    <!-- Header -->
+    <div class="flex items-center justify-between mb-6">
+        <div>
+            <h1 class="text-2xl font-bold theme-text flex items-center">
+                <span class="material-icons mr-3 text-blue-500">widgets</span>
+                {{ title|default:"Dashboard Widgets" }}
+            </h1>
+            <p class="text-gray-600 dark:text-gray-300 mt-2">
+                {% if data.has_widgets %}
+                    Showing {{ data.widgets_count }} widget{{ data.widgets_count|pluralize }}
+                {% else %}
+                    No widgets configured
+                {% endif %}
+            </p>
+        </div>
+    </div>
+
+    {% if data.has_widgets %}
+        <!-- Stats Widgets -->
+        {% if stats_widgets %}
+            {% for widget in stats_widgets %}
+                <div class="theme-card rounded-lg shadow-sm border theme-border mb-6">
+                    <!-- Widget Header -->
+                    <div class="p-6 border-b theme-border">
+                        <h2 class="text-lg font-semibold theme-text flex items-center">
+                            <span class="material-icons text-blue-500 mr-2">dashboard</span>
+                            {{ widget.title }}
+                        </h2>
+                    </div>
+
+                        <!-- Widget Content: Stats Cards -->
+                        <div class="p-6">
+                            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
+                                {% for card in widget.cards %}
+                                    <div class="theme-card p-6 rounded-lg shadow-sm border theme-border">
+                                        <div class="flex items-start justify-between mb-4">
+                                            <div class="flex-1">
+                                                <p class="text-sm text-gray-600 dark:text-gray-400 mb-2">
+                                                    {{ card.title }}
+                                                </p>
+                                                <p class="text-2xl font-bold theme-text">
+                                                    {{ card.value_template }}
+                                                </p>
+                                            </div>
+                                            {% if card.icon %}
+                                                <span class="material-icons text-{{ card.color }}-500 text-3xl">
+                                                    {{ card.icon }}
+                                                </span>
+                                            {% endif %}
+                                        </div>
+
+                                        {% if card.description %}
+                                            <p class="text-xs text-gray-500 dark:text-gray-400 mt-2">
+                                                {{ card.description }}
+                                            </p>
+                                        {% endif %}
+
+                                        {% if card.change %}
+                                            <div class="mt-3 flex items-center">
+                                                <span class="text-xs px-2 py-1 rounded
+                                                    {% if card.change_type == 'positive' %}
+                                                        bg-green-100 text-green-700 dark:bg-green-900/20 dark:text-green-400
+                                                    {% elif card.change_type == 'negative' %}
+                                                        bg-red-100 text-red-700 dark:bg-red-900/20 dark:text-red-400
+                                                    {% else %}
+                                                        bg-gray-100 text-gray-700 dark:bg-gray-700 dark:text-gray-400
+                                                    {% endif %}
+                                                ">
+                                                    {{ card.change }}
+                                                </span>
+                                            </div>
+                                        {% endif %}
+                                    </div>
+                                {% endfor %}
+                            </div>
+                        </div>
+                </div>
+            {% endfor %}
+        {% endif %}
+
+        <!-- Chart Widgets (if any) -->
+        {% if chart_widgets %}
+            {% for widget in chart_widgets %}
+                <div class="theme-card rounded-lg shadow-sm border theme-border p-6 mb-6">
+                        <h2 class="text-lg font-semibold theme-text mb-4">
+                            {{ widget.title }}
+                        </h2>
+                        <!-- Chart rendering would go here -->
+                        <div class="h-64 flex items-center justify-center text-gray-400">
+                            Chart widget rendering (TODO)
+                    </div>
+                </div>
+            {% endfor %}
+        {% endif %}
+
+        <!-- Custom Widgets (if any) -->
+        {% if custom_widgets %}
+            {% for widget in custom_widgets %}
+                <div class="theme-card rounded-lg shadow-sm border theme-border p-6 mb-6">
+                        <h2 class="text-lg font-semibold theme-text mb-4">
+                            {{ widget.title }}
+                        </h2>
+                        <!-- Custom widget rendering -->
+                        <div class="text-gray-600 dark:text-gray-300">
+                            Custom widget type: {{ widget.type }}
+                    </div>
+                </div>
+            {% endfor %}
+        {% endif %}
+
+    {% else %}
+        <!-- No Widgets State -->
+        <div class="theme-card rounded-lg shadow-sm border theme-border p-12 text-center">
+            <span class="material-icons text-gray-300 dark:text-gray-600 text-6xl mb-4">
+                widgets
+            </span>
+            <h3 class="text-lg font-semibold text-gray-600 dark:text-gray-400 mb-2">
+                No Widgets Configured
+            </h3>
+            <p class="text-sm text-gray-500 dark:text-gray-500">
+                Widgets can be added in DashboardManager.get_widgets_config()
+            </p>
+        </div>
+    {% endif %}
+</div>

django_cfg/templates/unfold/layouts/skeleton.html

@@ -0,0 +1,27 @@
+{% extends "unfold/layouts/skeleton.html" %}
+
+{% block extrastyle %}
+{{ block.super }}
+<style id="django-cfg-theme-sync">
+/* ============================================== */
+/* Django CFG - Force Color Variables            */
+/* Ensures COLORS from get_color_scheme() apply  */
+/* ============================================== */
+
+/*
+ * NOTE: Colors are already defined via UNFOLD['COLORS'] in:
+ * django_cfg/modules/django_unfold/models/config.py:get_color_scheme()
+ *
+ * This CSS just ensures Tailwind classes use those variables correctly.
+ */
+
+/* Ensure color-scheme is set for proper dark mode rendering */
+html.dark {
+  color-scheme: dark;
+}
+
+html:not(.dark) {
+  color-scheme: light;
+}
+</style>
+{% endblock %}

django_cfg/templatetags/django_cfg.py

@@ -4,6 +4,7 @@ Django-CFG Template Tags
 Provides template tags for accessing django-cfg configuration constants.
 """
 
+import os
 from django import template
 from django.utils.safestring import mark_safe
 from rest_framework_simplejwt.tokens import RefreshToken
@@ -134,3 +135,55 @@ def inject_jwt_tokens_script(context):
 }})();
 </script>"""
     return mark_safe(script)
+
+
+@register.simple_tag
+def nextjs_admin_url(path=''):
+    """
+    Get the URL for Next.js Admin Panel.
+
+    In development mode (when DJANGO_CFG_FRONTEND_DEV_MODE=true):
+        Returns http://localhost:3000/{path}
+
+    In production mode:
+        Returns /cfg/admin/{path}
+
+    Usage in template:
+        {% load django_cfg %}
+        <iframe src="{% nextjs_admin_url 'private' %}"></iframe>
+
+    Environment variable:
+        DJANGO_CFG_FRONTEND_DEV_MODE=true    # Enable dev mode
+        DJANGO_CFG_FRONTEND_DEV_PORT=3000    # Custom dev port (default: 3000)
+    """
+    # Check if frontend dev mode is enabled
+    is_dev_mode = os.environ.get('DJANGO_CFG_FRONTEND_DEV_MODE', '').lower() in ('true', '1', 'yes')
+
+    # Normalize path - ensure trailing slash for Django static view
+    if path and not path.endswith('/'):
+        path = f'{path}/'
+
+    if is_dev_mode:
+        # Development mode: use Next.js dev server
+        dev_port = os.environ.get('DJANGO_CFG_FRONTEND_DEV_PORT', '3000')
+        base_url = f'http://localhost:{dev_port}'
+        return f'{base_url}/{path}' if path else base_url
+    else:
+        # Production mode: use Django static files
+        return f'/cfg/admin/{path}' if path else '/cfg/admin/'
+
+
+@register.simple_tag
+def is_frontend_dev_mode():
+    """
+    Check if frontend is in development mode.
+
+    Returns True if DJANGO_CFG_FRONTEND_DEV_MODE environment variable is set to true.
+
+    Usage in template:
+        {% load django_cfg %}
+        {% if is_frontend_dev_mode %}
+            <div class="dev-badge">Dev Mode</div>
+        {% endif %}
+    """
+    return os.environ.get('DJANGO_CFG_FRONTEND_DEV_MODE', '').lower() in ('true', '1', 'yes')

{django_cfg-1.4.83.dist-info → django_cfg-1.4.85.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.83
+Version: 1.4.85
 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.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com