AdminPulse Pro

AdminPulse Pro - Documentation

Quick Start

# 1. Extract the ZIP file
unzip adminpulse-pro.zip
cd adminpulse

# 2. Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# 3. Install dependencies
pip install -r requirements.txt

# 4. Run migrations
python manage.py migrate

# 5. Load sample data
python manage.py seed_data

# 6. Start the server
python manage.py runserver

Visit http://127.0.0.1:8000 and login with admin / admin.

Demo Accounts

Features

1. Role-Based Dashboards

Four distinct dashboard layouts tailored to each role:
- Admin - Full access to all widgets, metrics, and management tools
- Manager - Team activity, project metrics, and performance charts
- Analyst - Data-focused with charts, trends, and export tools
- Viewer - Read-only overview with key KPIs

2. Drag-and-Drop Widget System

• Reorder widgets by dragging them to new positions
• Toggle widget visibility on/off
• Adjust widget width (narrow, medium, wide)
• Save your layout preferences (persisted per user)
• Reset to default layout with one click

3. Interactive Charts

• Revenue trend line chart
• Activity summary bar chart
• Metric comparison radar chart
• All powered by Chart.js 4.4

4. Dark/Light Mode

• Toggle between dark and light themes
• Preference saved to user account
• 5 sidebar color options
• 6 accent color options

5. Notification Center

• 4 notification types: info, success, warning, error
• Unread count badge in header
• Mark as read (individual or bulk)
• Auto-polling for new notifications

6. Theme Customizer

• 5 sidebar colors
• 6 accent colors
• Compact mode for power users
• All preferences persist per user

7. Advanced Search

• HTMX-powered instant search
• Category tabs (Users, Activity, Metrics)
• Paginated results

8. CSV Export

• Export users list to CSV
• Export activity data to CSV
• One-click download

9. REST API

4 DRF endpoints with browsable API:
- /api/activities/ - Activity log
- /api/metrics/ - Metrics data
- /api/notifications/ - Notifications
- /api/metric-history/ - Historical metric data

10. Responsive Design

• Mobile-first layout
• Collapsible sidebar
• Touch-friendly on tablets

Tech Stack

Customization

Adding Custom Widgets

1. Create a new partial template in templates/dashboard/partials/
2. Add the widget to the DASHBOARD_WIDGETS configuration
3. Assign it to roles in the dashboard view

Changing the Color Scheme

Edit the theme options in dashboard/context_processors.py to add or modify available colors.

Adding New Metrics

Use the Django admin at /admin/ to create new Metric objects, or extend the seed_data management command.

Production Deployment

# Set environment variables
export DEBUG=False
export SECRET_KEY=your-secret-key
export ALLOWED_HOSTS=yourdomain.com

# Collect static files
python manage.py collectstatic --noinput

# Run with gunicorn
gunicorn adminpulse.wsgi:application --bind 0.0.0.0:8000 --workers 3

Support

• Report bugs at djangozen.com/support
• Feature requests welcome
• All v1.x updates included free

Copyright 2026 DjangoZen. All Rights Reserved.