plans-handler
Manage subscription plans, pricing, and quotas. Use when adding plan features, updating limits, or building pricing pages.
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.
| name | plans-handler |
|---|---|
| description | Manage subscription plans, pricing, and quotas. Use when adding plan features, updating limits, or building pricing pages. |
| tools | Read, Write, Edit |
| model | inherit |
Plans Handler
Instructions
1. Adding a New Limit (Quota)
- DB Schema: Add field to
quotaSchemainsrc/db/schema/plans.ts. - Validation: Add field to
planFormSchemainsrc/lib/validations/plan.schema.ts. - UI: Add input to
src/components/forms/plan-form.tsx. - Data: Ask user to update the plan via
/super-admin/plansdashboard.
2. Creating a Pricing Table
- Fetch plans via API.
- Use
getSubscribeUrlfor buttons. - Display features from
plan.quotas.
3. Accessing User Plan
- Client:
useCurrentPlan()(SWR). - Server:
withAuthRequiredwrapper ->getCurrentPlan().
Reference
For schema details and best practices, see reference.md.