plan-catalog

What problem does it solve?

This Skill helps manage billing plans and pricing tiers by providing a versioned JSON catalog that serves as the single source of truth for the entire application, ensuring consistent pricing data across all systems.

Core Features & Use Cases

• Immutable Plan Entries: Plans are identified by immutable slugs, and changes are handled by adding new entries, preserving the integrity of existing subscriber terms.
• Two-axis Lifecycle: Plans can be publicly offered or retired, with separate control over their visibility and billability.
• Typed Loader: A robust loader validates and provides access to plan data, ensuring consistency and reducing the risk of billing errors.
• Stripe Price Binding: Each plan is linked to a Stripe price ID, simplifying integration with payment processing.
• Use Case: When implementing a new billing plan, this Skill allows you to add a new plan entry with a new slug and Stripe price, while keeping the old plan available for existing subscribers.

Quick Start

Add a new billing plan to the catalog using the add-plan command with the desired slug, tier, term, and price.