Metadata-Version: 2.4
Name: kdjango
Version: 0.1.3
Summary: A premium, Apple-style design for the Django Admin interface.
Author-email: Rocco Roma <rocco.roma034@gmail.com>
Project-URL: Homepage, https://gitlab.com/rococo034/kdjango
Project-URL: Bug Tracker, https://gitlab.com/rococo034/kdjango/-/issues
Project-URL: Repository, https://gitlab.com/rococo034/kdjango.git
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: django>=4.2
Dynamic: license-file

# KDjango 🍎

A premium, Apple-style UI for the Django Admin interface. This package transforms the default Django admin into a modern, polished experience with glassmorphism, responsive tabs, and enhanced interactive components.

## Features ✨

- **Apple Aesthetic**: Premium design system with glassmorphism, refined shadows, and iOS-like typography.
- **Tabbed Interface**: Automatically transforms complex forms (like User) and Inlines into clean, organized tabs.
- **Control Center Filters**: Modern, pill-based filter UI that is space-efficient and intuitive.
- **Portaling Selects**: Custom dropdowns that float above the content using `position: fixed` to avoid z-index and overflow issues.
- **Premium Tooltips**: Custom CSS-based tooltips with backdrop-blur and smooth animations.
- **Responsive & Minimalist**: Optimized for productivity and mobile usage.
- **Zero Configuration**: Just add to `INSTALLED_APPS` before `django.contrib.admin`.

## Installation 🚀

1. Install the package via pip:
   ```bash
   pip install kdjango
   ```

2. Add `kdjango` to your `INSTALLED_APPS` **above** `django.contrib.admin`:
   ```python
   INSTALLED_APPS = [
       'kdjango',
       'django.contrib.admin',
       ...
   ]
   ```

## Requirements 🛠️

- Django >= 4.2
- Python >= 3.10
- PrimeIcons & Tailwind CSS (included via CDN in the templates)

## Development 💻

To contribute or experiment with the code:
1. Clone the repository.
2. Install in editable mode: `pip install -e .`

For information on how to release new versions to PyPI, see the [Release Guide](docs/RELEASE.md).

## License 📄

MIT License
