django-admin

Design Community

Repo stars 0
Author repo skills-registry

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Django admin customization patterns for Nudge. Use when modifying the admin panel, adding models to admin, or changing admin bra…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Branding”, “Color palette”, “Django CSS variables to override”, “Admin access from the PWA”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name django-admin directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Branding / Color palette / Django CSS variables to override” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Django Admin — Nudge

Branding

The admin is branded to match Nudge's zinc-neutral + yellow-accent palette via a custom template: backend/templates/admin/base_site.html

This template:

Extends admin/base.html (NOT admin/base_site.html — that would loop)
Overrides Django's CSS variables for both light and dark mode
Sets the "Nudge" logo linking to / (the app, not /admin/)
Forces white text on dark headers in all theme modes
Repaints the "save" (default) submit button with the brand yellow (#fcd34d) so the primary CTA matches the app

Color palette

Mirrors frontend/src/index.css — source of truth lives there. If it changes, update this template too.

Token	Light	Dark
Primary (text / bg dark)	`#18181b`	`#fafafa`
Primary hover	`#27272a`	`#e4e4e7`
Accent (brand)	`#fcd34d`	`#fcd34d`
Body bg	`#fafafa`	`#0a0a0b`
Surface	`#ffffff`	`#18181b`
Border	`#e4e4e7`	`#27272a`
Link	`#09090b`	`#fafafa`
Link hover	`#27272a`	`#fcd34d`

Django CSS variables to override

The key to theming Django admin is overriding its own CSS custom properties: --header-bg, --module-bg, --link-fg, --button-bg, --breadcrumbs-bg, etc. Do this for :root, html[data-theme="light"], html[data-theme="dark"], and @media (prefers-color-scheme: dark) with :root:not([data-theme="light"]).

Admin access from the PWA

The frontend has an "Admin" button (staff users only) in the Header component. It works by creating a hidden form that POSTs the JWT token to /api/auth/admin-access/. The backend view (apps.users.views.admin_access):

Is @csrf_exempt (no CSRF token available from the SPA)
Validates the JWT, checks is_staff
Creates a Django session via django_login()
Redirects to /admin/

i18n

Django admin is multilingual out of the box. We enabled it by:

Adding django.middleware.locale.LocaleMiddleware to MIDDLEWARE (after SessionMiddleware, before CommonMiddleware)
Setting LANGUAGES = [("en", "English"), ("es", "Español"), ("gl", "Galego")]

The admin auto-detects language from the browser's Accept-Language header.

Registering models

Pattern used in apps/users/admin.py:

@admin.register(User)
class UserAdmin(BaseUserAdmin):
    fieldsets = BaseUserAdmin.fieldsets + (
        ("Nudge settings", {"fields": ("timezone", "daily_notification_time", "language")}),
    )
    list_display = ["username", "email", "timezone", "is_staff", "is_active"]
    list_filter = ["is_staff", "is_active", "timezone"]
    search_fields = ["username", "email"]

Source: cibrandocampo/nudge — distributed by TomeVault.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Design
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @tomevault-io · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: Unspecified
Runtime requirements: Python
Detected file/system behavior: Read-only
Write / modify
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview django-admin.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Django Admin — Nudge

## Branding

The admin is branded to match Nudge's zinc-neutral + yellow-accent palette via a custom template:
`backend/templates/admin/base_site.html`

This template:
- Extends `admin/base.html` (NOT `admin/base_site.html` — that would loop)
- Overrides Django's CSS variables for both light and dark mode
- Sets the "Nudge" logo linking to `/` (the app, not `/admin/`)
- Forces white text on dark headers in all theme modes
- Repaints the "save" (default) submit button with the brand yellow (`#fcd34d`) so the primary CTA matches the app

### Color palette

Mirrors `frontend/src/index.css` — **source of truth lives there**. If it changes, update this template too.

| Token           | Light      | Dark       |
|-----------------|------------|------------|
| Primary (text / bg dark) | `#18181b` | `#fafafa` |
| Primary hover   | `#27272a`  | `#e4e4e7`  |
| Accent (brand)  | `#fcd34d`  | `#fcd34d`  |
| Body bg         | `#fafafa`  | `#0a0a0b`  |
| Surface         | `#ffffff`  | `#18181b`  |
| Border          | `#e4e4e7`  | `#27272a`  |
| Link            | `#09090b`  | `#fafafa`  |
| Link hover      | `#27272a`  | `#fcd34d`  |

### Django CSS variables to override

The key to theming Django admin is overriding its own CSS custom properties:
`--header-bg`, `--module-bg`, `--link-fg`, `--button-bg`, `--breadcrumbs-bg`, etc.
Do this for `:root`, `html[data-theme="light"]`, `html[data-theme="dark"]`,
and `@media (prefers-color-scheme: dark)` with `:root:not([data-theme="light"])`.

## Admin access from the PWA

The frontend has an "Admin" button (staff users only) in the Header component.
It works by creating a hidden form that POSTs the JWT token to `/api/auth/admin-access/`.
The backend view (`apps.users.views.admin_access`):

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Branding → Color palette → Django CSS variables to override → Admin access from the PWA → i18n → Registering models
terms    -> source of truth lives there · Mirrors frontend/src/index.css — source of truth lives there. · The frontend has an "Admin" button (staff users only) in the Header component. · Django admin is multilingual out of the box. · The admin auto-detects language from the browser's Accept-Language header. · --- > Source: [cibrandocampo/nudge](https://github.com/cibrandocampo/nudge) — distributed by [TomeVault](https://tomevault.io).
files/cmd -> backend/templates/admin/basesite.html · admin/base.html · admin/basesite.html · (the app, not · #fcd34d · frontend/src/index.css · #18181b · #fafafa
body sha256 -> b816874a291c