django-admin-mobile 0.1.0__tar.gz

django_admin_mobile-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.tox/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+example/db.sqlite3
+example/media/
+tests/media/
+example/*.sqlite3
+tests/.test.sqlite3
+tests/test_*.sqlite3
+htmlcov/
+.coverage
+playwright-report/
+test-results/
+*.log

django_admin_mobile-0.1.0/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- Phone layout for the native Django admin: changelist cards, stacked tabular inlines, sticky submit row, 44px targets, 16px inputs.
+- Collapsible `#changelist-filter` toggle that does not depend on third-party filter packages.
+- `NativeDateInput`, `NativeTimeInput`, `NativeSplitDateTimeWidget`, and `MobileAdminMixin`.
+- Opt-in `ADMIN_MOBILE["USE_NATIVE_DATETIME"]` for every `ModelAdmin` and inline.
+- Light and dark surfaces use Django admin CSS variables only.
+- Phone layout for the rest of the built-in admin: login, password change, logout, index, nav sidebar, header, breadcrumbs, date hierarchy, pagination, list editing, select-all, sort links, facets and the empty filter, related-object widgets, raw id lookup, autocomplete, filter horizontal/vertical, radios, file clear, collapsed fieldsets, readonly fields, errors, stacked inlines, history, delete confirmation, popups, messages, calendar/clock, admindocs, and RTL.

django_admin_mobile-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing
+
+`django-admin-mobile` keeps the stock Django admin and only adds a stylesheet, a small script, and optional native date widgets.
+
+## Setup
+
+```bash
+uv sync --extra dev
+uv run python example/manage.py migrate
+```
+
+## Checks
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+uv run pytest -m "not playwright"
+uv run pytest -m playwright
+uv run tox
+```
+
+Playwright needs Chromium once: `uv run playwright install chromium`.
+
+The screenshot test writes `docs/screenshots/*.png`. Update those files in the same change when the phone layout changes.
+
+## Compatibility
+
+The tox and GitHub Actions matrices cover Django 4.2, 5.2, and 6.0 on Python 3.10+ (Django 6 requires 3.12+). Do not add a build step or a CDN. Static files ship as plain CSS and JavaScript.
+
+## Project layout
+
+- `src/admin_mobile/` is the installable app.
+- `example/` is a local admin with books, chapters, dates, and filters.
+- `tests/` covers settings, widgets, template injection, and the phone screenshots.
+
+Feature-Sliced Design is for product frontends. This repository stays a single Django app so `INSTALLED_APPS` can load it.

django_admin_mobile-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniil Shamraev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_admin_mobile-0.1.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.5
+Name: django-admin-mobile
+Version: 0.1.0
+Summary: Make the native Django admin usable on phones without replacing its look.
+Project-URL: Homepage, https://github.com/daniilshamraev/django-admin-mobile
+Project-URL: Repository, https://github.com/daniilshamraev/django-admin-mobile
+Project-URL: Issues, https://github.com/daniilshamraev/django-admin-mobile/issues
+Author: Daniil Shamraev
+License-Expression: MIT
+License-File: LICENSE
+Keywords: admin,django,mobile,responsive
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: JavaScript
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Requires-Dist: django>=4.2
+Provides-Extra: dev
+Requires-Dist: docutils>=0.20; extra == 'dev'
+Requires-Dist: playwright>=1.49; extra == 'dev'
+Requires-Dist: pytest-django>=4.9; extra == 'dev'
+Requires-Dist: pytest-playwright>=0.6; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: tox>=4.23; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# django-admin-mobile
+
+Phone layout for the **native** Django admin. It is not a theme: colors, typography, and chrome stay on Django's own CSS variables, including `html[data-theme]` and `prefers-color-scheme`.
+
+Targets Django 4.2 LTS, 5.x, and 6.x on Python 3.10+.
+
+![Changelist at 375px](docs/screenshots/changelist-375.png)
+
+![Change form at 375px](docs/screenshots/change-form-375.png)
+
+## Install
+
+```bash
+pip install django-admin-mobile
+```
+
+Put the app **before** `django.contrib.admin`:
+
+```python
+INSTALLED_APPS = [
+    "admin_mobile",
+    "django.contrib.admin",
+    # ...
+]
+```
+
+That is enough. `admin_mobile` overrides `admin/base.html`, calls `{{ block.super }}`, and appends its CSS and JS inside `extrastyle` and `extrahead`. Projects that only override `admin/base_site.html` keep working, because that template still extends `admin/base.html`.
+
+No CDN and no build step. The package ships plain files under `admin_mobile/static/`.
+
+## If you already override `admin/base.html`
+
+Django will use your template and skip this app's override. Load the tag yourself, and still call `{{ block.super }}`:
+
+```django
+{% extends "admin/base.html" %}
+{% load admin_mobile %}
+
+{% block extrastyle %}
+{{ block.super }}
+{% admin_mobile_assets "style" %}
+{% endblock %}
+
+{% block extrahead %}
+{{ block.super }}
+{% admin_mobile_assets "script" %}
+{% endblock %}
+```
+
+`{% admin_mobile_assets %}` emits both. If `admin_mobile` is listed after `django.contrib.admin`, system check `admin_mobile.W001` warns you.
+
+## Settings
+
+All keys are optional booleans.
+
+```python
+ADMIN_MOBILE = {
+    "ENABLED": True,
+    "CHANGELIST_CARDS": True,
+    "TABULAR_INLINE_STACK": True,
+    "STICKY_SUBMIT": True,
+    "TOUCH_TARGETS": True,
+    "COLLAPSIBLE_FILTERS": True,
+    "USE_NATIVE_DATETIME": False,
+}
+```
+
+| Key | Default | Effect |
+| --- | --- | --- |
+| `ENABLED` | `True` | Turn the stylesheet and script off. |
+| `CHANGELIST_CARDS` | `True` | At `≤600px`, changelist rows become cards. `data-label` is copied from the column header. From 601px to 1024px the table scrolls sideways instead. Checkboxes and links stay in the row. |
+| `TABULAR_INLINE_STACK` | `True` | Tabular inlines stack into labeled fields. The empty template row stays hidden, so Django's `inlines.js` can still add and delete rows. |
+| `STICKY_SUBMIT` | `True` | The last `.submit-row` sticks to the bottom of the viewport. The login page is left alone. |
+| `TOUCH_TARGETS` | `True` | Targets at least 44px, inputs at 16px (stops iOS from zooming), larger checkboxes. |
+| `COLLAPSIBLE_FILTERS` | `True` | `#changelist-filter` collapses behind a button. Django's filters, django-admin-rangefilter, and django-more-admin-filters render inside that node; this package does not import them. |
+| `USE_NATIVE_DATETIME` | `False` | Opt in to native date/time widgets on **every** `ModelAdmin` and inline. A custom `formfield_overrides` widget is kept. |
+
+Unknown keys and non-booleans raise `ImproperlyConfigured`.
+
+## Native date and time widgets
+
+Per model, without the global flag:
+
+```python
+from django.contrib import admin
+from admin_mobile.mixins import MobileAdminMixin
+from library.models import Book
+
+
+@admin.register(Book)
+class BookAdmin(MobileAdminMixin, admin.ModelAdmin):
+    pass
+```
+
+`MobileAdminMixin` must come before `admin.ModelAdmin` or `admin.TabularInline`. It sets `formfield_overrides` to:
+
+- `admin_mobile.widgets.NativeDateInput` (`<input type="date">`)
+- `admin_mobile.widgets.NativeTimeInput` (`<input type="time" step="1">`)
+- `admin_mobile.widgets.NativeSplitDateTimeWidget`
+
+Values stay on `SplitDateTimeField` / `DateField` / `TimeField`, so Django still validates them and still applies the current time zone. The widget renders the active zone (not the raw UTC instant) and prints that zone name under the inputs. ISO formats are required (`YYYY-MM-DD`, `HH:MM` or `HH:MM:SS`); a locale string such as `15.06.2024` is rejected. Microseconds are dropped, matching Django's admin split widget.
+
+These widgets do **not** load `DateTimeShortcuts`, so you do not get a second calendar on top of the native picker.
+
+## Example
+
+```bash
+uv sync --extra dev
+uv run python example/manage.py migrate
+uv run python example/manage.py runserver 127.0.0.1:8741
+```
+
+With `DEBUG` and `ADMIN_MOBILE_DEMO` (both set in `example/example/settings.py`) migrate creates a local superuser `admin` / `admin` and a few books. That password exists only for this demo. Do not set `ADMIN_MOBILE_DEMO` on a shared host; the seed refuses to run when `DEBUG` is off.
+
+Open http://127.0.0.1:8741/admin/ and narrow the window to 375px, or use device mode.
+
+![Filters open](docs/screenshots/filters-375.png)
+
+![Changelist, dark](docs/screenshots/changelist-375-dark.png)
+
+The same stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`, logical alignment).
+
+Further 375px captures live in `docs/screenshots/` (`login`, `index`, `nav-sidebar`, `edition`, `calendar`, `clock`, `history`, `delete-confirm`, `popup`, `admindocs`, `rtl-changelist`, and others).
+
+`Appointment` in the example keeps Django's calendar and clock. `Book` and `Edition` use `MobileAdminMixin`. `USE_NATIVE_DATETIME` stays off in the example so both modes are visible.
+
+## Tests
+
+```bash
+uv run ruff check .
+uv run pytest -m "not playwright"
+uv run playwright install chromium
+uv run pytest -m playwright
+uv run tox
+```
+
+`tox.ini` runs Django 4.2, 5.2, and 6.0. GitHub Actions adds Python 3.10–3.13 where each Django release allows it.
+
+## Publishing
+
+The package is not on PyPI yet.
+
+1. Create a GitHub repository and push this project.
+2. Add `[project.urls]` in `pyproject.toml` (`Homepage`, `Repository`, `Changelog`).
+3. Build: `uv build` (hatchling, src layout, static files and templates included).
+4. Publish: `uv publish` with a PyPI API token. The name `django-admin-mobile` has to be free on PyPI; the import name is `admin_mobile`.
+
+Author: Daniil Shamraev. License: MIT.

django_admin_mobile-0.1.0/README.md

@@ -0,0 +1,148 @@
+# django-admin-mobile
+
+Phone layout for the **native** Django admin. It is not a theme: colors, typography, and chrome stay on Django's own CSS variables, including `html[data-theme]` and `prefers-color-scheme`.
+
+Targets Django 4.2 LTS, 5.x, and 6.x on Python 3.10+.
+
+![Changelist at 375px](docs/screenshots/changelist-375.png)
+
+![Change form at 375px](docs/screenshots/change-form-375.png)
+
+## Install
+
+```bash
+pip install django-admin-mobile
+```
+
+Put the app **before** `django.contrib.admin`:
+
+```python
+INSTALLED_APPS = [
+    "admin_mobile",
+    "django.contrib.admin",
+    # ...
+]
+```
+
+That is enough. `admin_mobile` overrides `admin/base.html`, calls `{{ block.super }}`, and appends its CSS and JS inside `extrastyle` and `extrahead`. Projects that only override `admin/base_site.html` keep working, because that template still extends `admin/base.html`.
+
+No CDN and no build step. The package ships plain files under `admin_mobile/static/`.
+
+## If you already override `admin/base.html`
+
+Django will use your template and skip this app's override. Load the tag yourself, and still call `{{ block.super }}`:
+
+```django
+{% extends "admin/base.html" %}
+{% load admin_mobile %}
+
+{% block extrastyle %}
+{{ block.super }}
+{% admin_mobile_assets "style" %}
+{% endblock %}
+
+{% block extrahead %}
+{{ block.super }}
+{% admin_mobile_assets "script" %}
+{% endblock %}
+```
+
+`{% admin_mobile_assets %}` emits both. If `admin_mobile` is listed after `django.contrib.admin`, system check `admin_mobile.W001` warns you.
+
+## Settings
+
+All keys are optional booleans.
+
+```python
+ADMIN_MOBILE = {
+    "ENABLED": True,
+    "CHANGELIST_CARDS": True,
+    "TABULAR_INLINE_STACK": True,
+    "STICKY_SUBMIT": True,
+    "TOUCH_TARGETS": True,
+    "COLLAPSIBLE_FILTERS": True,
+    "USE_NATIVE_DATETIME": False,
+}
+```
+
+| Key | Default | Effect |
+| --- | --- | --- |
+| `ENABLED` | `True` | Turn the stylesheet and script off. |
+| `CHANGELIST_CARDS` | `True` | At `≤600px`, changelist rows become cards. `data-label` is copied from the column header. From 601px to 1024px the table scrolls sideways instead. Checkboxes and links stay in the row. |
+| `TABULAR_INLINE_STACK` | `True` | Tabular inlines stack into labeled fields. The empty template row stays hidden, so Django's `inlines.js` can still add and delete rows. |
+| `STICKY_SUBMIT` | `True` | The last `.submit-row` sticks to the bottom of the viewport. The login page is left alone. |
+| `TOUCH_TARGETS` | `True` | Targets at least 44px, inputs at 16px (stops iOS from zooming), larger checkboxes. |
+| `COLLAPSIBLE_FILTERS` | `True` | `#changelist-filter` collapses behind a button. Django's filters, django-admin-rangefilter, and django-more-admin-filters render inside that node; this package does not import them. |
+| `USE_NATIVE_DATETIME` | `False` | Opt in to native date/time widgets on **every** `ModelAdmin` and inline. A custom `formfield_overrides` widget is kept. |
+
+Unknown keys and non-booleans raise `ImproperlyConfigured`.
+
+## Native date and time widgets
+
+Per model, without the global flag:
+
+```python
+from django.contrib import admin
+from admin_mobile.mixins import MobileAdminMixin
+from library.models import Book
+
+
+@admin.register(Book)
+class BookAdmin(MobileAdminMixin, admin.ModelAdmin):
+    pass
+```
+
+`MobileAdminMixin` must come before `admin.ModelAdmin` or `admin.TabularInline`. It sets `formfield_overrides` to:
+
+- `admin_mobile.widgets.NativeDateInput` (`<input type="date">`)
+- `admin_mobile.widgets.NativeTimeInput` (`<input type="time" step="1">`)
+- `admin_mobile.widgets.NativeSplitDateTimeWidget`
+
+Values stay on `SplitDateTimeField` / `DateField` / `TimeField`, so Django still validates them and still applies the current time zone. The widget renders the active zone (not the raw UTC instant) and prints that zone name under the inputs. ISO formats are required (`YYYY-MM-DD`, `HH:MM` or `HH:MM:SS`); a locale string such as `15.06.2024` is rejected. Microseconds are dropped, matching Django's admin split widget.
+
+These widgets do **not** load `DateTimeShortcuts`, so you do not get a second calendar on top of the native picker.
+
+## Example
+
+```bash
+uv sync --extra dev
+uv run python example/manage.py migrate
+uv run python example/manage.py runserver 127.0.0.1:8741
+```
+
+With `DEBUG` and `ADMIN_MOBILE_DEMO` (both set in `example/example/settings.py`) migrate creates a local superuser `admin` / `admin` and a few books. That password exists only for this demo. Do not set `ADMIN_MOBILE_DEMO` on a shared host; the seed refuses to run when `DEBUG` is off.
+
+Open http://127.0.0.1:8741/admin/ and narrow the window to 375px, or use device mode.
+
+![Filters open](docs/screenshots/filters-375.png)
+
+![Changelist, dark](docs/screenshots/changelist-375-dark.png)
+
+The same stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`, logical alignment).
+
+Further 375px captures live in `docs/screenshots/` (`login`, `index`, `nav-sidebar`, `edition`, `calendar`, `clock`, `history`, `delete-confirm`, `popup`, `admindocs`, `rtl-changelist`, and others).
+
+`Appointment` in the example keeps Django's calendar and clock. `Book` and `Edition` use `MobileAdminMixin`. `USE_NATIVE_DATETIME` stays off in the example so both modes are visible.
+
+## Tests
+
+```bash
+uv run ruff check .
+uv run pytest -m "not playwright"
+uv run playwright install chromium
+uv run pytest -m playwright
+uv run tox
+```
+
+`tox.ini` runs Django 4.2, 5.2, and 6.0. GitHub Actions adds Python 3.10–3.13 where each Django release allows it.
+
+## Publishing
+
+The package is not on PyPI yet.
+
+1. Create a GitHub repository and push this project.
+2. Add `[project.urls]` in `pyproject.toml` (`Homepage`, `Repository`, `Changelog`).
+3. Build: `uv build` (hatchling, src layout, static files and templates included).
+4. Publish: `uv publish` with a PyPI API token. The name `django-admin-mobile` has to be free on PyPI; the import name is `admin_mobile`.
+
+Author: Daniil Shamraev. License: MIT.

django_admin_mobile-0.1.0/example/example/settings.py

@@ -0,0 +1,75 @@
+"""Local demo settings. Do not deploy this module."""
+
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = "example-only-not-a-secret"
+DEBUG = True
+ALLOWED_HOSTS = ["127.0.0.1", "localhost"]
+ADMIN_MOBILE_DEMO = True
+
+INSTALLED_APPS = [
+    "admin_mobile",
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "django.contrib.admindocs",
+    "library",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "example.urls"
+WSGI_APPLICATION = "example.wsgi.application"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    }
+]
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+AUTH_PASSWORD_VALIDATORS = []
+
+LANGUAGE_CODE = "en-us"
+TIME_ZONE = "Europe/Moscow"
+USE_I18N = True
+USE_TZ = True
+
+STATIC_URL = "static/"
+MEDIA_URL = "media/"
+MEDIA_ROOT = BASE_DIR / "media"
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+# Native widgets are opt-in per model via MobileAdminMixin.
+# AppointmentAdmin keeps Django's calendar and clock.
+ADMIN_MOBILE = {
+    "USE_NATIVE_DATETIME": False,
+}

django_admin_mobile-0.1.0/example/example/urls.py

@@ -0,0 +1,7 @@
+from django.contrib import admin
+from django.urls import include, path
+
+urlpatterns = [
+    path("admin/doc/", include("django.contrib.admindocs.urls")),
+    path("admin/", admin.site.urls),
+]

django_admin_mobile-0.1.0/example/example/wsgi.py

@@ -0,0 +1,7 @@
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "example.settings")
+
+application = get_wsgi_application()