image

Django SmartBase Admin

A modern, modular, and developer-friendly admin interface for Django.
Built to speed up development of internal tools and admin panels — beautifully and efficiently.

✨ Features

  • Fast integration with any Django project
  • Improved performance of Django List Admin using SBAdminField, database annotate() and values() to avoid direct object access
  • Simple configuration of menu structure, dashboard components, and permissions per user role
  • Enhanced Django List Admin filters: autocomplete support for related fields and filtering across all model fields
  • Ability for users to save and reuse custom filters in Django List Admin
  • Improved Django Detail Admin with autocomplete for relational fields
  • Support for "FakeInlines" – define inline-like blocks without requiring a direct model relationship
  • Easy extension of list and detail views with custom actions and corresponding views
  • Beautiful modern UI (Tailwind CSS)
  • Responsive & mobile-friendly
  • End-user ready for building SaaS or similar projects with global queryset configuration
  • Built-in audit logging — automatically tracks all admin create, update, and delete operations with full change history, snapshots, and request grouping
image image image image image image image image image image image image

📚 Full Documentation (in progress)

🗂 View Full Docs

🌐 Live Demo

Want to see it in action?
👉 Check out the live demo

Login credentials:

  • Admin role: admin / admin
  • Editor role: editor / editor

⚡ Quick Start

1. Install Smartbase Admin

Begin by installing the Smartbase Admin package using pip:

pip install django-smartbase-admin

Ensure that django-smartbase-admin and its dependencies are included in your Django settings. Open your settings.py file and add the following to INSTALLED_APPS:

INSTALLED_APPS = [
    # other apps
    "django_smartbase_admin",
    "easy_thumbnails",
    "widget_tweaks",
    "ckeditor",
    "ckeditor_uploader",
]

2. Add Admin URL Configuration

In your project’s urls.py, register the Smartbase Admin site by importing sb_admin_site and adding the path:

from django_smartbase_admin.admin.site import sb_admin_site

urlpatterns = [
    path("sb-admin/", sb_admin_site.urls),
    # other paths
]

This makes the Smartbase Admin interface accessible at /sb-admin/

3. Define the SmartBase Admin Configuration

In your project, for example in config package create a file called sbadmin_config.py with the following content:

from django_smartbase_admin.engine.configuration import SBAdminConfigurationBase, SBAdminRoleConfiguration
from django_smartbase_admin.views.dashboard_view import SBAdminDashboardView
from django_smartbase_admin.engine.menu_item import SBAdminMenuItem

config = SBAdminRoleConfiguration(
    default_view=SBAdminMenuItem(view_id="dashboard"),
    menu_items=[
        SBAdminMenuItem(view_id="dashboard", icon="All-application"),
    ],
    registered_views=[
        SBAdminDashboardView(widgets=[], title="Dashboard"),
    ],
)

class SBAdminConfiguration(SBAdminConfigurationBase):
    def get_configuration_for_roles(self, user_roles):
        return config

4. Reference the Configuration in settings.py

SB_ADMIN_CONFIGURATION = "config.sbadmin_config.SBAdminConfiguration"

5. Add Locale Middleware

Add the following middleware to support internationalization:

MIDDLEWARE = [
    # Other middleware...
    'django.middleware.locale.LocaleMiddleware',
]

Enable Django i18n URLs so {% url 'set_language' %} is available for the navigation language picker:

from django.urls import include, path

urlpatterns = [
    path("i18n/", include("django.conf.urls.i18n")),
]

🔍 Audit Logging

Built-in optional audit app that automatically tracks all admin create, update, delete, and bulk operations with field-level diffs, snapshots, and request grouping. Just add "django_smartbase_admin.audit" to INSTALLED_APPS and run migrations.

See AGENTS.md — Audit Logging for setup and configuration.

🤖 AI/Developer Reference

See AGENTS.md for development patterns, gotchas, and AI assistant instructions.

🤝 Need Help with Development?

We at SmartBase are experts in Django and custom software.

Whether you're building a new platform or modernizing an internal tool — 💡 We can help you design, build, and scale it.

📬 Let's talk — We'd love to work with you.

Project links

Data verified by PyPI on Aug 26, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.3.9)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for smartbase from gravatar.com smartbase

Credits

Author: SmartBase

GitHub Statistics

Data verified by PyPI on Aug 26, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python <4.0, >=3.10

Provides Extra

mcp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_smartbase_admin-2.3.6.tar.gz (3.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_smartbase_admin-2.3.6-py3-none-any.whl (4.1 MB view details)

Uploaded Python 3

File details

Details for the file django_smartbase_admin-2.3.6.tar.gz.

File metadata

  • Download URL: django_smartbase_admin-2.3.6.tar.gz
  • Upload date:
  • Size: 3.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_smartbase_admin-2.3.6.tar.gz
Algorithm Hash digest
SHA256 eb4978635794b96e62f877a9e2e035fb8dedd6e73517de8a52067186d2b650ff
MD5 b60b5af2cc5fe0f2231f4aee8ae1e710
BLAKE2b-256 5ffcd270ab6685e607850bb5ae4ad88d5ed8ddfe28397e204b21f07f4ce88bfe

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_smartbase_admin-2.3.6.tar.gz:

Publisher: workflow.yml on SmartBase-SK/django-smartbase-admin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file django_smartbase_admin-2.3.6-py3-none-any.whl.

File metadata

File hashes

Hashes for django_smartbase_admin-2.3.6-py3-none-any.whl
Algorithm Hash digest
SHA256 9056d5237d53f03dbad53b3a0c13a4da4941e5c096e2cdf44501e9960ad486c7
MD5 192e69dd5ff508944f33038631060463
BLAKE2b-256 e58a77eb977c15cb26f5c2c0e88180cfff09726ab3ef6ddbc0b5ed41406f34ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_smartbase_admin-2.3.6-py3-none-any.whl:

Publisher: workflow.yml on SmartBase-SK/django-smartbase-admin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.3.9

2 files

2.3.8

2 files

2.3.7

2 files

This release

2.3.6 This release

2 files

2.3.5

2 files

2.3.4

2 files

Pre-release

2.3.4b1

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.1

2 files

2.1.0

2 files

2.0.19

2 files

2.0.18

2 files

Pre-release

2.0.17b4

2 files

Pre-release

2.0.17b3

2 files

Pre-release

2.0.17b2

2 files

Pre-release

2.0.17b1

2 files

2.0.16

2 files

2.0.15

2 files

2.0.14

2 files

2.0.13

2 files

2.0.12

2 files

Pre-release

2.0.12b1

2 files

2.0.11

2 files

Pre-release

2.0.10b2

2 files

Pre-release

2.0.10b1

2 files

2.0.9

2 files

2.0.8

2 files

2.0.7

2 files

2.0.6

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.7

2 files

1.4.6

2 files

1.4.5

2 files

1.4.4

2 files

1.4.3

2 files

1.4.2

2 files

1.4.1

2 files

Pre-release

1.4.1b1

2 files

1.4.0

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.0

2 files

1.1.13

2 files

Pre-release

1.1.13b3

2 files

Pre-release

1.1.13b2

2 files

Pre-release

1.1.13b1

2 files

1.1.12

2 files

1.1.11

2 files

1.1.10

2 files

1.1.9

2 files

1.1.8

2 files

1.1.7

2 files

Pre-release

1.1.7b1

2 files

1.1.5

2 files

Pre-release

1.1.5b9

2 files

Pre-release

1.1.5b8

2 files

Pre-release

1.1.5b7

2 files

Pre-release

1.1.5b6

2 files

Pre-release

1.1.5b5

2 files

Pre-release

1.1.5b4

2 files

Pre-release

1.1.5b3

2 files

Pre-release

1.1.5b2

2 files

Pre-release

1.1.5b1

2 files

Pre-release

1.1.5b0

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.45

2 files

1.0.44

2 files

1.0.43

2 files

1.0.42

2 files

1.0.41

2 files

1.0.40

2 files

1.0.38

2 files

1.0.37

2 files

1.0.36

2 files

1.0.35

2 files

1.0.34

2 files

1.0.33

2 files

1.0.32

2 files

1.0.31

2 files

1.0.30

2 files

1.0.29

2 files

1.0.28

2 files

1.0.27

2 files

1.0.26

2 files

1.0.25

2 files

1.0.24

2 files

1.0.23

2 files

1.0.22

2 files

1.0.21

2 files

1.0.19

2 files

1.0.18

2 files

1.0.17

2 files

1.0.16

2 files

1.0.15

2 files

1.0.14

2 files

1.0.13

2 files

1.0.12

2 files

1.0.11

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

Pre-release

1.0.6b3

2 files

Pre-release

1.0.6b2

2 files

Pre-release

1.0.6b1

2 files

1.0.5

2 files

Pre-release

1.0.4b1

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.2.101

2 files

0.2.100

2 files

0.2.99

2 files

0.2.98

2 files

0.2.97

2 files

0.2.95

2 files

0.2.94

2 files

0.2.93

2 files

0.2.92

2 files

0.2.91

2 files

0.2.90

2 files

0.2.89

2 files

0.2.88

2 files

0.2.87

2 files

0.2.86

2 files

0.2.85

2 files

0.2.84

2 files

0.2.83

2 files

0.2.82

2 files

0.2.81

2 files

0.2.80

2 files

0.2.79

2 files

0.2.78

2 files

0.2.77

2 files

0.2.76

2 files

0.2.75

2 files

0.2.74

2 files

0.2.73

2 files

0.2.72

2 files

0.2.71

2 files

0.2.70

2 files

0.2.69

2 files

0.2.68

2 files

0.2.67

2 files

0.2.66

2 files

0.2.65

2 files

0.2.64

2 files

0.2.63

2 files

0.2.62

2 files

0.2.61

2 files

0.2.60

2 files

0.2.59

2 files

0.2.58

2 files

0.2.57

2 files

0.2.56

2 files

0.2.55

2 files

0.2.54

2 files

0.2.53

2 files

0.2.52

2 files

0.2.51

2 files

0.2.50

2 files

0.2.49

2 files

0.2.48

2 files

0.2.47

2 files

0.2.46

2 files

0.2.45

2 files

0.2.44

2 files

0.2.43

2 files

0.2.42

2 files

0.2.41

2 files

0.2.40

2 files

0.2.39

2 files

0.2.38

2 files

0.2.37

2 files

0.2.36

2 files

0.2.35

2 files

0.2.34

2 files

0.2.33

2 files

0.2.32

2 files

0.2.31

2 files

0.2.30

2 files

0.2.29

2 files

0.2.28

2 files

0.2.27

2 files

0.2.26

2 files

0.2.25

2 files

0.2.24

2 files

0.2.23

2 files

0.2.22

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page