Compliance dashboard

Conventions only matter if they hold over time. The compliance dashboard tells you whether they do, with numbers instead of impressions. It is part of the Pro plan.

Run a check

  1. Open a repository in Riff.
  2. Start a compliance check. It is one click.
  3. Riff checks the repository history against your team convention and publishes the results to the dashboard in the Gapfy web portal.

By default the convention is Conventional Commits, and it is fully editable, so the check measures your rules, not someone else's.

The dashboard in the Gapfy web portal shows:

  • A per-repository score, so you see at a glance which repos follow the convention and which drift.
  • Trends over time, so the adoption of a new rule is visible week by week.
  • Top violations, so you know exactly which part of the convention people struggle with.

That last list deserves a careful read. A violation that dominates it is rarely laziness; it usually means the rule is unclear or the template needs a better field. Fix the rule, not the people.

Edit the convention

The convention the check runs against is fully editable:

  1. Open the Gapfy web portal.
  2. Edit the convention to match your team's rules, starting from the Conventional Commits default if you like.
  3. Run a new check to score history against the updated convention.

The same central definitions drive live validation in Riff, so tightening a rule changes both what people see while typing and what the dashboard measures. And as with all conventions, an invalid pattern fails open in the client, so an editing mistake never blocks a developer. See Commit and branch templates.

Make it a habit

Because a check is one click, it fits into any routine:

  1. Run a check right after rolling out a new rule to get a baseline.
  2. Watch the trend for a few weeks instead of reacting to a single score.
  3. When the same violation keeps topping the list, revisit the template rather than repeating the rule in chat.

Teams rarely disagree about whether conventions are good. They disagree about whether they are being followed. The dashboard ends that discussion with data.