pricing-tiers
ReleaseWatch subscription tiers, pricing strategy, and Pro feature definitions. Use when discussing pricing plans, comparing tiers, implementing tier-gated features, or setting up Polar integration.
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for managing SaaS monetization, specifically tailored for the ReleaseWatch platform. It encompasses detailed subscription tier definitions, pricing strategies, and technical implementation guides for Polar integration. By centralizing Pro feature definitions, database schemas for limit enforcement, and grandfathering rules, it enables seamless management of revenue streams and user access control.
Use Cases
- Case 1: Implementing and enforcing tiered access control (Free vs. Pro) for features like repository tracking, AI summaries, and webhook integrations.
- Case 2: Configuring and managing Polar integration, including setting up environment variables for sandbox/production and handling subscription webhooks.
- Case 3: Executing pricing strategy transitions, such as moving from launch pricing to regular pricing while maintaining grandfathered rates for early adopters.
- Case 4: Designing and querying database schemas to track user limits and reset monthly usage metrics for AI-driven features.
| name | pricing-tiers |
|---|---|
| description | ReleaseWatch subscription tiers, pricing strategy, and Pro feature definitions. Use when discussing pricing plans, comparing tiers, implementing tier-gated features, or setting up Polar integration. |
Subscription Tiers
Tier Comparison
| Feature | Free | Pro |
|---|---|---|
| Repos tracked | 25 | Unlimited |
| AI summaries | 25/month | Unlimited |
| Channels | Telegram, Discord, Email | All + webhooks |
| Webhooks | 1 | 5 |
| Check frequency | 15 min | 15 min |
| Release type filters | Yes | Yes |
| Notification history | 7 days | 90 days |
| GitHub stars import | - | Yes |
Pricing Strategy
Launch (Early Adopters):
- Monthly: $3/mo (locked in forever)
- Annual: $30/yr (2 months free)
Regular (After Launch):
- Monthly: $5/mo
- Annual: $50/yr (2 months free)
Grandfathering
Polar handles automatically:
- Create products at launch price
- After launch period, update prices in Polar dashboard
- Existing subscribers keep original price forever
Pro Features
Notification History
- Store notification events in
notification_historytable GET /notifications/historyendpoint (Pro only)- 90-day retention
- UI:
/dashboard/history
Webhook Integrations
- Free: 1 webhook
- Pro: 5 webhooks
- Store in
user_webhookstable - Fire on release notification
GitHub Stars Import
- Pro-only feature
- Fetch starred repos via GitHub API
- UI: Cherry-pick which repos to import
Database Schema
// packages/database/src/schema/user-limits.ts
export const userLimits = pgTable("user_limits", {
userId: text().primaryKey().references(() => users.id, { onDelete: "cascade" }),
tier: text().default("free").notNull(), // 'free' | 'pro'
aiSummariesUsed: integer().default(0).notNull(),
aiSummariesResetAt: timestamp(), // Reset monthly
});
Limit Enforcement
const TIER_LIMITS = {
free: { maxRepos: 25, maxAiSummaries: 25, maxWebhooks: 1 },
pro: { maxRepos: Infinity, maxAiSummaries: Infinity, maxWebhooks: 5 },
};
Apply middleware to:
POST /repos- Check repo count vs tier limitPOST /webhooks- Check webhook count vs tier limit- AI analysis in workflow - Check monthly AI summary usage
Polar Integration
Environment variables (set per environment):
POLAR_SERVER-sandboxorproductionPOLAR_PRODUCT_ID_PRO_MONTHLY- Product ID for monthly planPOLAR_PRODUCT_ID_PRO_ANNUAL- Product ID for annual plan
Sandbox Product IDs:
pro-monthly:c43ab049-bafd-45ff-a48c-c6dbc3167411pro-annual:b1bc732e-3bf3-4672-8e0a-e34267202903
Checkout URLs:
/api/auth/checkout/pro-monthly/api/auth/checkout/pro-annual
Webhook handlers:
onSubscriptionCreated→ Update user tier to 'pro'onSubscriptionCanceled→ Downgrade to 'free'
UI Touchpoints
- Pricing page:
/app/(marketing)/pricing/page.tsx - Upgrade prompts: Show when approaching limits
- Settings: Subscription management via Polar portal
- Feature teasers: "Available with Pro" for gated features