GROWTH PATTERN

Implementing Usage-Based Billing with Billflow

Billflow processes payments reliably, but there's no system to track usage and automatically prompt upgrades when free users hit limits.

Billflow

Last updated:

What's Missing in Standard Billflow Architecture

Billflow manages billing, but free users can access all features without hitting conversion triggers because usage isn't tracked.

Standard Billflow Flow vs Optimized Skene Flow

Standard Flow
1

User subscribes via Billflow

2

Subscription active but no usage limits enforced

3

Free users can access all features without limits

Skene Flow
1

Monitor usage in database and Billflow subscription status

2

Detect when free tier user hits usage limit

3

Block feature access and trigger upgrade prompt email

4

Track conversion from free to paid

Visual comparison of the flows:

Loading diagram...

How Skene Fixes This

We built a Skene Prompt that installs freemium gating for Billflow. It monitors usage in your database and Billflow subscription status, automatically blocking features and triggering upgrade prompts when free users hit limits.

Implementation Comparison

Using Skene Infrastructure

Install via Prompt

cursor.mdc
@task: Initialize Skene.
@action: Analyze my local code, validating subscription via `npx skene login`, and generate `skene.config.ts` to implement the Freemium Gating pattern for Billflow.

Copy Skene Prompt for Cursor

Generated skene.config.ts

skene.config.ts
// skene.config.ts - The Automated Way
import { defineLoop } from '@skene/sdk';

export default defineLoop({
  type: 'freemium',
  opinion: 'Enforce usage limits for free tier users and trigger upgrade prompts',
  steps: [
    {
      trigger: {
        type: 'api',
        endpoint: '/api/features/*',
        method: 'POST'
      },
      condition: {
        type: 'usage',
        limit: {
          free: 100,
          paid: Infinity
        },
        period: '30d'
      },
      action: {
        type: 'block',
        message: 'You've reached your free tier limit. Upgrade to continue.',
        upgradePrompt: {
          type: 'email',
          provider: 'resend',
          template: 'upgrade_prompt'
        }
      }
    }
  ],
  recovery: {
    retries: 0 // No retries for blocking actions
  }
});

Frequently asked questions