Skip to main content
Polaris IDE uses a subscription-based billing model powered by Autumn (Stripe integration) to provide flexible pricing options for individuals and teams.

​
Subscription Model

Polaris offers a tiered subscription system with three main plans:

Free

Perfect for getting started with up to 10 projects

Pro Monthly

Unlimited projects billed monthly

Pro Yearly

Unlimited projects with annual billing

​
Autumn Integration

Polaris uses Autumn as the billing infrastructure, which provides:
  • Stripe-powered payments: Secure payment processing through Stripe
  • Customer portal: Self-service billing management
  • Subscription lifecycle: Automatic handling of trials, upgrades, downgrades, and cancellations
  • Usage tracking: Real-time project limit enforcement

​
How It Works

  1. Authentication: Users authenticate via Stack Auth
  2. Customer creation: Autumn creates a customer record tied to your Stack Auth user ID
  3. Subscription sync: Subscription status is synced from Autumn to Convex database
  4. Access control: Project limits are enforced based on subscription tier
Your Autumn customer ID is automatically linked to your Stack Auth user ID for seamless billing management.

​
Billing Flow

The billing system follows this flow:

​
Key API Endpoints

EndpointPurposeLocation
/api/autumn/checkoutCreate Stripe checkout sessionsrc/app/api/autumn/checkout/route.ts:14
/api/autumn/portalOpen billing portalsrc/app/api/autumn/portal/route.ts:5
/api/autumn/syncSync subscription statussrc/app/api/autumn/sync/route.ts:84

​
Free vs Pro Tiers

​
Free Tier

  • Projects: 10 projects maximum
  • Cost: $0/month
  • Status: free
  • Ideal for: Personal projects, learning, experimentation
// From convex/schema.ts:4
export const FREE_PROJECT_LIMIT = 10;

​
Pro Tiers

Both Pro plans include:
  • Projects: Unlimited (projectLimit: -1)
  • Trial period: 7 days
  • Subscription status: active or trialing
  • Ideal for: Professional developers, teams, production projects
During trial period, you get full Pro access with unlimited projects. The trial lasts 7 days from subscription start.

​
Subscription States

Polaris tracks the following subscription states:
StatusDescriptionProject Access
freeFree tier user10 projects
trialingIn 7-day trial periodUnlimited
activeActive paid subscriptionUnlimited
past_duePayment failed, grace periodUnlimited
pausedSubscription paused10 projects
canceledSubscription canceled10 projects
Subscription status is defined in convex/schema.ts:13-21 and automatically synced from Autumn.

​
Environment Configuration

To enable billing, configure these environment variables: 
# Autumn credentials
AUTUMN_SECRET_KEY=sk_...
AUTUMN_API_URL=https://api.autumn.sh  # Optional, defaults to production

# Product IDs from Autumn dashboard
NEXT_PUBLIC_AUTUMN_PRO_MONTHLY_PRODUCT_ID=prod_...
NEXT_PUBLIC_AUTUMN_PRO_YEARLY_PRODUCT_ID=prod_...

# Return URLs
NEXT_PUBLIC_APP_URL=https://your-domain.com

​
Next Steps

View Plans

Compare features and pricing across all tiers

Manage Subscription

Learn how to upgrade, downgrade, and manage billing

Build docs developers (and LLMs) love

Get started for freeTalk to us