Skip to content

Conversation

@marksftw
Copy link
Contributor

@marksftw marksftw commented Feb 3, 2026

Summary

Renames "API credits" to "extra credits" throughout the UI to better communicate their
purpose.

Problem

The term "API credits" may be confusing, especially for developers who use both the Maple
chat interface and the Maple API:

  • Mental model mismatch: "API credits" suggests they're consumed when making API calls, but
    they're actually consumed last—plan credits are used first for both chat AND API usage
  • Unclear purpose: The name doesn't communicate that these credits are overflow/backup
    credits that kick in when plan credits run out
  • Potential confusion: When hitting the API from a dev tool, plan credits decrease while
    "API credits" remain unchanged—the opposite of what the name suggests

Solution

Rename to "extra credits" which more accurately describes their behavior:

  • They extend your usage when plan credits run out
  • They work for both chat and API (not API-specific)
  • The name "extra" implies overflow/bonus, matching the actual behavior

This aligns with how Claude handles a similar concept with "Extra usage" in their billing
UI—neutral terminology that communicates "this kicks in when you exceed your plan."

Changes

  • CreditUsage.tsx - sidebar display
  • UpgradePromptDialog.tsx - upgrade prompts
  • BillingStatus.tsx - billing status messages
  • ApiCreditsSection.tsx - credits balance label
  • ApiKeyDashboard.tsx - API settings description
  • pricing.tsx - FAQ section

Open with Devin

Summary by CodeRabbit

  • Style
    • Updated terminology across the billing and pricing interface, replacing "API credits" with "extra credits" in upgrade dialogs, purchase prompts, credit balance displays, and FAQ content.

Updates user-facing terminology from "API credits" to "extra credits"
to better reflect their purpose as overflow credits that extend usage
when plan credits run out.
@coderabbitai
Copy link

coderabbitai bot commented Feb 3, 2026

📝 Walkthrough

Walkthrough

This pull request updates user-facing text across six frontend billing and pricing components, systematically replacing "API credits" terminology with "extra credits" in labels, messages, buttons, and FAQ items. No functional logic or control flow changes are introduced.

Changes

Cohort / File(s) Summary
Billing & Credit UI Components
frontend/src/components/BillingStatus.tsx, frontend/src/components/CreditUsage.tsx, frontend/src/components/UpgradePromptDialog.tsx, frontend/src/components/apikeys/ApiCreditsSection.tsx, frontend/src/components/apikeys/ApiKeyDashboard.tsx
Text updates replacing "API credits" with "extra credits" in billing status messages, credit balance labels, upgrade dialog descriptions, button labels, and subscription prompts.
Pricing Page
frontend/src/routes/pricing.tsx
FAQ section text updated to change references from "API credits" to "extra credits" in two bullet points describing credit usage and purchasing.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related issues

Possibly related PRs

  • feat: merge subscription credits with API credits UI updates #407: This PR appears to be a follow-up adjustment to #407, which added the "extra credits" feature; the current changes align the UI terminology with that new feature.
  • Remove starter plan #141: Both PRs modify the same core billing components (BillingStatus, CreditUsage, pricing.tsx), with this PR updating copy while #141 modifies underlying plan-related logic in those same areas.
  • Usage visibility #30: Both PRs touch the same billing UI components (CreditUsage, BillingStatus), with this PR's terminology updates complementing #30's structural additions to those components.

Poem

🐰 A rabbit hops through billing screens so bright,
Swapping API words for "extra" with delight,
No logic changed, just copy neat and clean,
The friendliest refactor ever seen! ✨

🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely describes the main change: renaming API credits to extra credits across UI copy.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch credits-copy-updates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional flags.

Open in Devin Review

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 3, 2026

Greptile Overview

Greptile Summary

This PR renames "API credits" to "extra credits" throughout the frontend UI to better communicate their purpose and reduce user confusion.

Key Changes

  • Terminology update: Replaced all user-facing instances of "API credits" with "extra credits" across 6 frontend files
  • Improved clarity: The new terminology better reflects that these credits extend usage for both chat and API access, not just API calls
  • Consistent implementation: Updated all UI touchpoints including billing status messages, upgrade prompts, credit balance displays, and FAQ content

Analysis

The changes are purely cosmetic - only user-facing string literals were modified. No logic, API contracts, or data structures were changed. The underlying backend still uses api_credit_balance in the data model, which is appropriate as the field name doesn't need to match the UI copy.

The PR description provides strong justification for this change: the term "API credits" created a mental model mismatch where users expected these credits to be consumed during API calls, when in reality they serve as overflow credits consumed last (after plan credits) for both chat and API usage.

All changes follow a consistent pattern and appear complete across the UI surface area reviewed.

Confidence Score: 5/5

  • This PR is completely safe to merge with no risk
  • The changes are purely cosmetic string updates with no logic modifications, no API contract changes, and no potential for runtime errors. The terminology change is well-justified and consistently applied across all UI components.
  • No files require special attention

Important Files Changed

Filename Overview
frontend/src/components/UpgradePromptDialog.tsx Updated upgrade prompts, benefits lists, and button text to use "extra credits" terminology throughout
frontend/src/components/apikeys/ApiCreditsSection.tsx Changed credit balance label from "API Credit Balance" to "Extra Credit Balance"
frontend/src/routes/pricing.tsx Updated FAQ section to consistently use "extra credits" terminology for API access question

Sequence Diagram

sequenceDiagram
    participant User
    participant UI as UI Components
    participant BillingService
    participant Backend

    Note over User,Backend: Credit Purchase Flow (Terminology Update)
    
    User->>UI: Views credit balance
    UI->>UI: Display "Extra Credit Balance"
    
    User->>UI: Clicks "Buy Extra Credits"
    UI->>BillingService: purchaseApiCredits()
    BillingService->>Backend: POST /api/credits/purchase
    Backend-->>BillingService: checkout_url
    BillingService-->>UI: Redirect to checkout
    
    Note over User,Backend: After successful payment
    
    User->>UI: Returns to app
    UI->>BillingService: getApiCreditBalance()
    BillingService->>Backend: GET /api/credits/balance
    Backend-->>BillingService: { balance: updated_amount }
    BillingService-->>UI: Updated balance
    UI->>UI: Display "+ X extra credits"
    
    Note over User,Backend: Usage Limit Reached
    
    User->>UI: Attempts to chat (plan credits exhausted)
    UI->>UI: Show UpgradePromptDialog
    UI->>UI: Display "Purchase extra credits to continue"
    User->>UI: Clicks "Buy Extra Credits"
    UI->>BillingService: Navigate to credit purchase
Loading

@AnthonyRonning AnthonyRonning merged commit 14fde9d into master Feb 3, 2026
14 of 15 checks passed
@AnthonyRonning AnthonyRonning deleted the credits-copy-updates branch February 3, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants