Resolución de problemas

Se sigue viendo el admin de Django

Comprueba que instalaste el paquete en el mismo entorno que ejecuta Django y que newadmin precede a django.contrib.admin. Revisa los overrides en TEMPLATES['DIRS'] y las aplicaciones anteriores a newadmin: pueden ocultar las plantillas del tema.

python -m pip show django-newadmin
python manage.py check
python manage.py findstatic newadmin/css/newadmin.css --verbosity 2

Estáticos ausentes, sin estilos o iconos

Ejecuta collectstatic, verifica STATIC_URL y el servicio de estáticos, y limpia la caché del navegador. No mezcles plantillas de una versión con CSS de otra. ManifestStaticFilesStorage necesita todos los archivos del paquete en su manifiesto.

Errores de configuración

Los checks del tema distinguen ajustes inválidos (newadmin.E001/E002), rutas de recursos (E003), menú (E004) y orden de aplicaciones (E005). El mensaje indica qué corregir. LOGO/CUSTOM_CSS usan rutas de staticfiles, sin URL externa ni ...

Si un enlace nombrado no se puede resolver, comprueba su nombre, namespace y el registro de modelos en ese AdminSite. No se usa otro sitio como fallback. Los modelos/enlaces ocultos pueden deberse a permisos: no desactives su comprobación.

El dashboard no aparece o no muestra datos

Comprueba la ruta importable de DASHBOARD, la subclase, template_name y los permisos del usuario. Sin permisos se muestra el escritorio genérico. Los datos se filtran en el proveedor, no en el frontend. Revisa la consola si falla ECharts; los datos deben seguir disponibles en la tabla alternativa.

Personalizaciones que cambian el contraste o los controles

Comprueba los tres modos y la navegación con teclado después de añadir CSS o widgets. Conserva block.super en los bloques de recursos. Prueba por separado las pantallas del admin que sustituyas completamente.

Al reportar un problema incluye versiones de Python/Django/NewAdmin, navegador, pantalla afectada, pasos y un ejemplo mínimo sin credenciales ni datos personales.