drf-dark-shade

A dark theme for django rest framework browsable api


Keywords
python, drf, drf-dark-theme, dark-theme, django-rest-framework, djangorestframework
License
MIT
Install
pip install drf-dark-shade==0.1.5

Documentation

drf-dark-shade

Enhance your Django Rest Framework (DRF) browsing experience with the drf-dark-shade package. This lightweight and easy-to-use extension bring a sleek dark theme to the DRF browsable API, reducing eye strain and providing a modern, visually appealing interface for developers.

Deep Forest Theme:

Screenshot from 2023-11-21 12-45-09

Installation:

  1. Install drf-dark-shade package using pip or poetry
pip install drf_dark_shade
  1. Add drf_dark_shade to your INSTALLED_APPS in your Django project's settings.
INSTALLED_APPS = [
    # other packages
    'rest_framework', # drf required
    'drf_dark_shade',
]
  1. Add drf_dark_shade renderer to REST_FRAMEWORK config
REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': (
        'rest_framework.renderers.JSONRenderer',
        'drf_dark_shade.renderers.DeepForestBrowsableAPIRenderer',
    )
}

Override templates

To override providing templates:

  1. Configure root templates dir in your django app
TEMPLATES = [
    {
        ...
        # configure root templates
        'DIRS': [os.path.join(BASE_DIR, "templates")],
        'APP_DIRS': True,
        ...
    },
]
  1. Create template to override with name of the theme you want, like:
    templates/drf_dark_shade/deep-forest.html

All set! now run app and visit your API endpoint.
Enjoy Dark 🌃

Contribution

Contributions are welcome!
If you encounter issues or want to add new features, feel free to open pull requests.
Give a ⭐️ if you find this project interesting and useful!