Usage and Billing
The Usage page and Billing & Plans page give you visibility into your resource consumption, invoice history, and subscription management.
Access both pages from the account menu in the top-right of the dashboard.
Usage Page
Navigate to the Usage page via Account menu → Usage (route: /usage).
The Usage page contains three sections:
- Over-limit banner (conditionally shown)
- Usage meters — visual progress bars for each metered resource
- Your projects — a table listing all your projects
- Invoice history — a table of past invoices
Over-Limit Banner
If any resource has exceeded its plan limit, a warning banner appears at the top of the Usage page. The message varies by tier:
| Tier | Title | Action |
|---|---|---|
| Free | "You've hit the Free plan limit" | Upgrade to Hobby |
| Hobby | "You're at the Hobby limit" | Upgrade to Pro |
| Pro | "Currently hit the resource limit" | Manage Plan |
The banner includes a button that links to the Billing & Plans page.
Usage Meters
The Usage Meters section shows a progress card for each metered resource. Currently tracked resources:
Projects
- Shows how many projects you have created vs. your plan limit
- Example:
3 / 5
API Requests
- Shows the number of API requests made this billing period vs. your plan limit
- Displays the reset date (e.g.
Resets Apr 1) - Example:
8,450 / 10,000
Meter Color States
Each meter card changes color based on consumption:
| State | Threshold | Color |
|---|---|---|
| Healthy | Under 80% | Green border and bar |
| Warning | 80-99% | Amber border and bar |
| At limit | 100% | Amber border and bar, "Upgrade for more" link |
| Over limit | Over 100% | Red border and bar |
| Grace zone | 100-110% (API Requests only) | Amber bar, "Grace zone" label |
When a meter is at its limit, an "Upgrade for more" link appears below the bar, pointing to the Billing & Plans page.
When a resource is unlimited (not applicable on current plans), the meter displays / unlimited instead of a numeric limit.
Your Projects
Below the usage meters, a table lists all projects in your account:
| Column | Description |
|---|---|
| Name | Project display name |
| Slug | The URL-safe slug used in API paths |
| Created | The date the project was created |
Invoice History
The Invoice History section shows all past invoices for your account. Invoices appear only if you have a Stripe subscription (paid plans).
| Column | Description |
|---|---|
| Date | Invoice creation date |
| Tier | The plan tier billed (e.g. Hobby, Pro) |
| Amount | Total amount paid |
| Status | Paid, Pending, Failed, or Void |
| Period | Billing period covered by the invoice |
Invoice status badges use color coding:
- Paid — green
- Pending — amber
- Failed — red
- Void — dim/neutral
If no invoices exist yet, the section shows "No invoices yet".
Billing & Plans Page
Navigate to Billing & Plans via Account menu → Billing & Plans (route: /plans).
This page displays available subscription tiers and lets you upgrade or change your plan. After completing a Stripe Checkout session, the dashboard automatically returns you to this page.
Stripe Customer Portal
On the Account Settings page, Stripe customers can access the Stripe Customer Portal for self-service billing management (update payment method, cancel subscription, download invoices).
See Account Settings for details on the Stripe portal button.