PulseForUmbraco 1.0.0

Pulse for Umbraco

Your Umbraco site's operational health monitor. Pulse scans your content, configuration, performance, and security — giving you an actionable health score and one-click remediation from inside the backoffice.

✨ Features

🏥 Health Scanning & Scoring

• 40+ built-in rules across 5 categories — Content Health, Site Setup, Performance, Access & Security, and Content Quality
• Overall health score (0–100) with per-category breakdowns
• Severity levels — OK, Advisory, Attention, and Urgent — so you know what to fix first
• Real-time scan progress — see which rule is being evaluated and track completion

🔧 One-Click Remediation

• Empty recycle bins, disable stale users, delete unused document/data types — directly from the dashboard
• Per-rule rescan to verify your fix worked
• "How to Fix" guidance — contextual remediation steps in a sidebar for every rule

🎯 Custom Scans

• Pick specific rules and run a targeted scan without affecting your persisted results
• Save and manage presets — create named rule selections for repeatable scans
• Results are read-only and do not trigger notifications or affect your score history

📊 History & Trend Analysis

• Score sparkline tracks your site health over time
• Trend alerts detect score drops, sustained declines, and new critical issues
• Up to 90 historical scan snapshots

⏰ Scheduled Scans

• Choose a preset (every 6h, 12h, daily, weekly) or set a custom interval
• Configure preferred scan time and day of week
• Manage the schedule from the backoffice Settings view — changes take effect immediately

🔔 Notifications

• Email digests when your score drops below a threshold or new urgent issues appear
• Weekly digest emails — automated summary of your site health delivered on schedule
• Backoffice banner alerts — dismissible per-notification
• Configurable cooldown to avoid inbox flooding
• Test email endpoint to verify SMTP before relying on alerts

👤 Issue Assignments & Collaboration

• Assign issues to backoffice users directly from the drilldown view
• Email notifications sent to the assignee on assignment
• Inline feedback panel — add comments and track progress per issue
• To-do list — each user can view their open assignments
• Comment editing and deletion with author/admin permissions

🚫 Suppressions

• Suppress entire rules or individual items with an optional reason and expiry
• Suppressed items are excluded from scoring — your score reflects what matters

🏆 Achievements

• Earn badges by running scans, fixing issues, exporting reports, completing the tour, and more
• Progress tracker with categorised achievement cards
• Unlocked automatically as you use Pulse

🌐 Multi-Site Support

• Site picker in the dashboard for installations with multiple root content nodes
• Per-site scans run on demand and are scoped to the selected site

📈 Site Stats

• At-a-glance content, media, and member statistics for your Umbraco installation
• Useful context alongside your scan results

📥 CSV Export

• Download a full scan report as CSV — share with your team or archive for compliance

🎓 Guided Tour

• Built-in interactive tour walks new users through the dashboard on first visit

📋 Requirements

🚀 Installation

Install via NuGet:

dotnet add package PulseForUmbraco

Or via the Package Manager Console:

Install-Package PulseForUmbraco

Pulse automatically creates its database tables on first startup — no manual migration steps required.

⚙️ Configuration

Add the following section to your appsettings.json to customise Pulse's behaviour. All settings are optional — sensible defaults are applied.

{
  "Umbraco": {
    "Pulse": {
      "Enabled": true,
      "ScanIntervalHours": 24,
      "InitialDelaySeconds": 60,
      "BatchSize": 500,
      "LargeMediaThresholdMB": 5,
      "MaxContentDepth": 7,
      "MaxDocTypeProperties": 50,
      "StaleUserDays": 90,
      "StaleContentDays": 180,
      "ThinContentWordThreshold": 300,
      "ReadabilityMinScore": 30,
      "MetaDescriptionAliases": "metaDescription,seoMetaDescription,description",
      "ListViewContentThreshold": 50,
      "TrendAlertScoreDropThreshold": 10,
      "TrendAlertConsecutiveDeclines": 3,
      "TrendAlertSnapshotWindow": 10,
      "Schedule": {
        "Preset": "Daily",
        "CustomIntervalHours": 24,
        "PreferredHourUtc": 2,
        "PreferredDayOfWeek": "Sunday"
      },
      "Notifications": {
        "EmailEnabled": false,
        "EmailRecipients": "",
        "EmailFrom": "",
        "ScoreThreshold": 70,
        "NotifyOnNewCritical": true,
        "NotifyOnScoreDrop": true,
        "ScoreDropThreshold": 10,
        "BackofficeBannerEnabled": true,
        "CooldownHours": 24
      }
    }
  }
}

Configuration reference

Schedule presets

Tip: The schedule can also be managed from the Settings tab in the Pulse backoffice section — changes take effect immediately without restarting.

🏗️ Scan Rules

Content Health

Site Setup

Performance

Access & Security

Content Quality

🖥️ Dashboard Tabs

👥 Authors

• Paul de Quant — @pauldequant
• Jon Roberts

Built with ❤️ for the Umbraco community