All Docs
FeaturesSaaS FactoryUpdated February 19, 2026

Revenue Drop Alerting: MRR/ARR Warning Thresholds

Revenue Drop Alerting: MRR/ARR Warning Thresholds

Available since: v1.0.38

Overview

The Revenue Dashboard now includes automated alert thresholds for MRR and ARR movements. When month-over-month (MoM) MRR growth falls below -10%, the platform automatically surfaces a warning, sends a notification, and can escalate to the Revenue Discovery Agent — no human monitoring required.

How It Works

1. Daily Threshold Check

The billing cron (billing-crons.ts) runs daily and computes the current MoM MRR delta. If the delta crosses the -10% threshold, the following automated sequence fires:

Daily billing-crons.ts run
  └─ Compute MoM MRR delta
       ├─ Delta < -10%  →  sendNotification({ type: 'revenue_drop', ... })
       │                    Revenue tab warning banner displayed
       │                    [Optional] Revenue Discovery Agent triggered
       └─ Delta ≥ -10%  →  No action (normal rendering)

2. Warning Banner

When the threshold is breached, the Revenue tab displays a persistent warning banner at the top of the page. The banner:

  • Appears automatically — no manual configuration needed.
  • Remains visible until MoM growth recovers above -10%.
  • Complements (does not replace) the existing red-label rendering for negative MoM figures.

3. Notification Events

Two new event types have been added to the NotificationEvent type:

Event TypeTrigger Condition
revenue_dropMoM MRR growth falls below -10%
churn_spikeChurn rate exceeds configured threshold

These events flow through the existing sendNotification infrastructure, meaning they appear wherever your notification integrations are configured (in-app, email, Slack, etc.).

4. Revenue Discovery Agent Escalation

The revenue_drop event can optionally trigger the Revenue Discovery Agent. When activated, the agent autonomously searches for monetization improvement opportunities — turning a passive alert into active recovery.

Threshold Reference

MetricDefault ThresholdNotification EventBanner Shown
MoM MRR Growth-10%revenue_dropYes
Churn RateConfigurablechurn_spike—

Affected Files

FileChange
NotificationEvent typeAdded revenue_drop and churn_spike event types
billing-crons.tsDaily run now checks MoM delta and triggers sendNotification
Revenue DashboardWarning banner rendered when threshold is breached

Behavior Before v1.0.38

Prior to this release, the Revenue Dashboard displayed MoM growth in red when negative (e.g., -25%), but:

  • No alert or banner was surfaced on the dashboard.
  • No notification was sent via the notification system.
  • No automated escalation occurred.
  • The NotificationEvent type had no revenue_drop or churn_spike entries.

All revenue monitoring was passive and required a human to notice the red figure.

Related