plans-handler

Manage subscription plans, pricing, and quotas. Use when adding plan features, updating limits, or building pricing pages.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026⬇️2downloads

When & Why to Use This Skill

The Plans Handler skill is a specialized developer utility designed to streamline the management of SaaS subscription infrastructures, pricing models, and usage quotas. It provides a structured framework for implementing full-stack billing features, from database schema definitions and server-side validation to front-end UI components and API integrations. By standardizing how subscription plans are updated and accessed, it significantly reduces development time and ensures consistency in feature gating and resource limit enforcement.

Use Cases

  • SaaS Feature Scaling: Quickly add new subscription tiers or modify existing plan features by following a guided workflow for DB schema updates and UI integration.
  • Dynamic Pricing Tables: Build and maintain real-time pricing pages that automatically fetch plan data and generate secure checkout URLs for users.
  • Usage Quota Management: Implement and update granular resource limits (e.g., storage, API calls) across the application to manage operational costs and upsell opportunities.
  • Full-Stack Access Control: Integrate standardized hooks like useCurrentPlan() and server-side wrappers to enforce plan-based permissions and gate premium content.
  • Administrative Dashboard Automation: Streamline the process of updating plan limits and features via a centralized super-admin interface.
nameplans-handler
descriptionManage subscription plans, pricing, and quotas. Use when adding plan features, updating limits, or building pricing pages.
toolsRead, Write, Edit
modelinherit

Plans Handler

Instructions

1. Adding a New Limit (Quota)

  1. DB Schema: Add field to quotaSchema in src/db/schema/plans.ts.
  2. Validation: Add field to planFormSchema in src/lib/validations/plan.schema.ts.
  3. UI: Add input to src/components/forms/plan-form.tsx.
  4. Data: Ask user to update the plan via /super-admin/plans dashboard.

2. Creating a Pricing Table

  1. Fetch plans via API.
  2. Use getSubscribeUrl for buttons.
  3. Display features from plan.quotas.

3. Accessing User Plan

  • Client: useCurrentPlan() (SWR).
  • Server: withAuthRequired wrapper -> getCurrentPlan().

Reference

For schema details and best practices, see reference.md.