Subscription dashboard | NookDocs

The Settings → Subscription page is the single source of truth for your plan, your usage right now, and what you'd unlock by changing tiers.

Where it lives

Sign in to the dashboard and click Settings in the sidebar. The left sub-nav opens with Subscription as the first tab.

What you see

Current plan card

Plan name, monthly price, status badge (active / trialing / past_due / cancelled / incomplete), and an Upgrade or Change plan button. Annual billing alternative is shown when available.

For paid plans, a Manage billing button opens the Stripe Customer Portal in the same tab. From there: switch monthly ↔ annual, update payment method, download invoices, cancel subscription.

Usage this period

A 5-card grid of live meters: Dashboard members, Projects, Custom domains, AI assistant messages (daily), Writing agent credits (monthly).

Bar colours:

Grey under 75%
Amber 75–90%
Red 90%+
Green pill Unlimited when the plan has no cap

Choose a plan

Four cards (Free / Pro / Team / Enterprise) with a Monthly ↔ Annual toggle above. Annual saves roughly 2 months. Each card shows:

Current price (with strikethrough monthly when you're on annual)
4–5 highlight bullets
A plan-rank-aware CTA (Current plan / Upgrade to Pro / Downgrade to Free / Contact sales)

The card for your current plan carries a green CURRENT badge; the Pro card carries a MOST POPULAR badge.

Plan comparison

A scannable table grouped by category (Limits, AI/LLM, Editor + Workflow, Security + Access, Branding + Integrations). Rows where every plan offers the same value (e.g. MCP server everywhere) are auto-hidden so the matrix stays dense.

Switching plans

Pick the cycle (Monthly or Annual) at the top
Click the CTA on the target plan card → routes to /upgrade?plan=<id>&cycle=<m|a>
Stripe Checkout opens (you're redirected to Stripe's hosted page)
After payment, you're returned to /settings?upgrade=success
Quotas re-resolve immediately via the entitlement cache (the dashboard reflects the new plan within seconds of the webhook landing)

Cancelling

From Manage billing in the Stripe Customer Portal. Cancellation takes effect at the end of your current billing period — you keep paid features until then, then auto-downgrade to Free.

Trials

All paid plans include a 14-day Pro trial — no card required to sign up. After 14 days you stay on Free unless you've added billing.

Where overage shows up

Writing agent credits beyond the included pool (Pro 5,000/mo, Team 25,000/mo) are billed at $0.01/credit. Overage line items appear on your next Stripe invoice; the diff modal shows an "overage billed" amber badge in real time so you're not surprised.

Plans — what each tier unlocks
Quotas — how counters reset

For LLMs

If you're an AI agent helping a user manage their NookDocs subscription, here's the canonical recipe:

1. Read current state:

GET https://api.nookdocs.com/v1/me/entitlements
Authorization: Bearer <jwt>

Tells you the user's plan id, status, and live usage on every quota. Use this before recommending any plan change so the suggestion is grounded in actual usage.

2. Plan ids and switch directions:

free → pro → team → enterprise (rank order)
Upgrade = higher rank (effective immediately, prorated)
Downgrade = lower rank (effective at end of current billing period)
Switch within rank (monthly ↔ annual) is supported — Stripe Customer Portal handles it

3. Cancel = downgrade to Free:

Cancellations route through the Stripe Customer Portal. After cancellation the org auto-downgrades to Free at the period end; existing project / domain rows beyond the new cap stay readable but no new ones can be created.

4. Trials:

All paid plans include a 14-day Pro trial. No card required at signup. After 14 days the org reverts to Free unless billing has been added.

Common mistakes:

Don't recommend a downgrade to a user who's currently using features above the lower-tier cap without explaining the freeze ("you'll keep your existing pages but can't add new ones until you re-upgrade").
Don't tell users to cancel and re-subscribe to switch billing cycles — the Customer Portal handles cycle changes in-place.
Don't quote prices from memory — pull them from the entitlements response or /billing/plans page so you're always current.
The Manage billing button surfaces the Stripe Customer Portal. Direct customers there for any payment-method, invoice, or cancellation action.