⚠️ Note: This package is currently in active development.

django_kpi is a Django package designed to create flexible Key Performance Indicators (KPIs) for your projects. This package allows you to define, track, and manage KPIs with ease.

• Define custom KPIs
• Track KPI performance over time (WIP)
• Flexible configuration options
• Easy integration with existing Django projects

To install django_kpi, use pip:

pip install django_kpi

1. Add django_kpi to your INSTALLED_APPS in your Django settings:

   INSTALLED_APPS = [
       ...
       'django_kpi',
   ]

2. Update your urls.py to include the django_kpi URLs:

   from django.urls import path, include
   urlpatterns = [
       ...
       path('kpi/', include('django_kpi.urls')),
   ]

3. Run the migrations to create the necessary database tables:

   python manage.py migrate

4. Define your KPIs in the Django admin interface or through the provided API.

5. Use KpiCards on your views check example

Contributions are welcome! Please submit a pull request or open an issue to discuss your ideas.

This project is licensed under the MIT License. See the LICENSE file for details.

For questions or support, please contact mchahboun@majaracapital.com.