improvement(pricing): increase free user limit to 20 usd

[icecrasher321]

Summary

Free plan pricing to 20 dollars of credit

Type of Change

• Other: Pricing

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Dec 23, 2025 3:43am

[greptile-apps]

Greptile Summary

This PR successfully increases the free user credit limit from $10 to $20 and reduces the hosted model pricing multiplier from 2.5x to 2x, making the platform more accessible.

What changed:

• Updated DEFAULT_FREE_CREDITS constant from 10 to 20 in both apps/sim/lib/billing/constants.ts and packages/db/constants.ts
• Created database migration 0131_illegal_nova.sql to update the default value for user_stats.current_usage_limit column
• Updated English documentation (costs.mdx) with new 2x multiplier and recalculated all hosted model prices
• Updated test notification data to reflect new $20 limit

Outstanding issue:
As noted in previous review threads, the localized documentation files (French and Spanish) still show the old 2.5x multiplier and outdated prices. These should be updated to maintain consistency across all languages.

Confidence Score: 4/5

• Safe to merge with one documentation inconsistency to address post-merge
• The core implementation is correct and consistent across constants, migrations, and English documentation. The pricing change is a business decision that has been properly propagated through the codebase. Database migration is simple and safe. Score of 4 (not 5) due to incomplete localized documentation updates that were flagged in previous review threads.
• Localized documentation files (apps/docs/content/docs/fr/execution/costs.mdx and apps/docs/content/docs/es/execution/costs.mdx) still reference old 2.5x multiplier and outdated prices

Important Files Changed

Filename	Overview
apps/sim/lib/billing/constants.ts	Updated DEFAULT_FREE_CREDITS from 10 to 20, consistent with database constant
packages/db/constants.ts	Updated DEFAULT_FREE_CREDITS from 10 to 20, matches app constant
packages/db/schema.ts	No changes - correctly imports DEFAULT_FREE_CREDITS from constants
packages/db/migrations/0131_illegal_nova.sql	Migration correctly updates user_stats.current_usage_limit default to '20'
apps/docs/content/docs/en/execution/costs.mdx	Updated pricing multiplier from 2.5x to 2x, all model prices updated, free tier limit changed to $20

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant Constants as Constants Files
    participant Migration as DB Migration
    participant Schema as DB Schema
    participant UserStats as user_stats Table
    participant Docs as Documentation

    Dev->>Constants: Update DEFAULT_FREE_CREDITS: 10 → 20
    Constants->>Constants: apps/sim/lib/billing/constants.ts
    Constants->>Constants: packages/db/constants.ts
    
    Dev->>Migration: Generate migration 0131
    Migration->>UserStats: ALTER COLUMN current_usage_limit DEFAULT '20'
    
    Schema->>Constants: Import DEFAULT_FREE_CREDITS
    Schema->>UserStats: Use constant for default value
    
    Dev->>Docs: Update pricing tables
    Docs->>Docs: Change multiplier: 2.5x → 2x
    Docs->>Docs: Recalculate all hosted prices
    Docs->>Docs: Update free tier limit: $10 → $20
    
    Note over UserStats: New users get $20 credit
    Note over Docs: English docs updated ✓
    Note over Docs: FR/ES docs need update ⚠️

Loading

[greptile-apps]

_{2 files reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

[icecrasher321]

@greptile