Credits are what you spend when building with Caffeine. Depending on your account, you may have welcome credits, subscription credits, top-up credits, and voucher credits.
Welcome credits — 10 credits granted at signup on the Free plan. These expire 30 days after they are added to your account.
Subscription credits — your monthly allowance based on your plan (20 for Host, 100 for Studio). These refresh every billing cycle. Unused subscription credits do not roll over.
Top-up credits — purchased separately as a one-time top-up by subscribers. These expire 6 months after purchase.
Voucher credits — credits added from a voucher or promo code. These expire 3 months after redemption, and you need an active subscription to redeem them.
What credits are spent on
Not everything costs credits. The main actions that do:
- AI builds — between 1 and 7 credits per build, depending on the complexity of the work. Simple builds cost 1 credits; more complex builds that require greater AI effort cost up to 7 credits. Credits are held when the AI starts building your app. If the build succeeds, the held credits become the charge. If the build fails for any reason — including a compile error — the held credits are released back to your account and you are not charged.
- Going live — 4 credits to publish your draft to the live version. This charge applies when deployment is triggered, whether or not the deployment succeeds.
- AI image generation — 1 credit per image generated in the App Market listing form. Reusing a previously generated image from the gallery does not cost an additional credit.
- File storage — credits are deducted when files are uploaded, while they remain in storage, and when they are downloaded. These appear as two line items in your transaction history: Storage Cost (uploads and the space your files occupy) and Bandwidth Cost (data transferred when files are accessed). See File Storage Costs for the full pricing breakdown.
- Live canister maintenance — once your app is live, Caffeine automatically keeps it running by topping up its compute resources as needed. These top-ups are billed proportionally to the amount of resources actually deposited — you are only ever charged for what your app uses, not rounded up to a whole credit.
Many common actions cost nothing: creating a draft, deploying to draft, cloning a project.
How credits are spent
Credits are always spent in this order:
- Welcome credits first
- Subscription credits second
- Top-up and voucher credits last
This means longer-lasting paid credits are preserved for as long as possible. One exception: older purchased top-up credits are spent before subscription credits.
Checking your balance
Your credit balance is shown in the top bar of the Caffeine interface. The number reflects your available credits — your total balance minus any credits currently held for in-progress activity. Credits held for an active build are released back to your account if the build fails. For a full transaction history, go to Profile avatar → Credit usage.
Getting more credits
- Upgrade your plan — the main way to increase your monthly credit allowance. Go to Profile avatar → Membership / Upgrade.
- Purchase top-up credits — a one-time top-up available to subscribers from the billing section without changing your subscription. The Top up button appears in your credit and billing settings only if you are on a paid plan. Available packs are 100 credits for $50, 200 credits for $100, and 500 credits for $250.
- Redeem a voucher — if you have a voucher or promotional code, go to Profile avatar → Use promo code. Credit vouchers add credits to your account for 3 months. Subscription vouchers activate a paid subscription for a set period — for example, 1 month of Host or 1 month of Studio. After that period the subscription ends automatically unless you renew it. Redeeming the wrong kind of code won't silently fail — if a code isn't valid or has already been used, you'll see an error message.
- Sign up — Free users receive 10 welcome credits at signup, valid for 30 days.
Frequently asked questions
How many credits do I get on the Free plan?
Free users receive 10 welcome credits at signup, valid for 30 days.
Do welcome credits roll over?
No. Welcome credits expire 30 days after they are added to your account.
Do subscription credits roll over?
No. Unused subscription credits expire at the end of your billing period when the new cycle starts.
When do top-up and voucher credits expire?
Top-up credits expire 6 months after purchase. Voucher credits expire 3 months after redemption.
What happens when I run out of credits?
When your credit balance drops too low, a notice appears just above the chat input. What the notice says — and what action it offers — depends on your account:
- Not signed in — you see a prompt to sign up and claim your welcome credits.
- Signed in on the free plan — you see "Out of credits — building is locked" (or "Low on credits" if you have a small amount left) with a link to subscribe to a paid plan.
- On a paid plan — you see the same locked message with a "Get more credits" button to top up your balance.
Your app is not changed and no build runs while credits are insufficient. You can still view and share your apps.
If your credits run out at the exact moment a new build is starting — after you've sent a message but before the AI has begun generating — you will see an out-of-credits message posted directly in the chat. The build does not start and no credits are charged.
What happens if I try to build a new app from scratch on the Free plan?
Starting a new app from scratch is handled separately from the regular out-of-credits flow. If you are signed in on the Free plan and you send a prompt to build a new app from scratch, Caffeine posts a message in the chat telling you to subscribe to a paid plan, with two buttons, Subscribe and Browse the App Market, and no build runs.
To unlock building from scratch you can subscribe to any paid plan (Host or Studio). If you would rather not subscribe, remix any app from the App Market instead — it lands in your account as a new project that you can iterate on with your available credits.
If you have already subscribed or received credits and you still see the earlier subscribe-to-build message in your chat, simply send your prompt again — that bubble swaps to a brief "you're all set — try sending your prompt again" acknowledgement and the build runs normally.
What happens to my credits if I cancel my subscription?
Subscription credits are tied to your billing period and expire when your subscription ends. Top-up and voucher credits are also cancelled when your paid subscription ends.
What happens to my credits if my payment fails?
Subscription credits expire immediately when a payment fails and your account reverts to the Free plan. Credits are restored only after Stripe successfully collects payment. See the billing article for full details.
Do I get credits when I sign up?
Yes. Free users receive 10 welcome credits at signup, valid for 30 days.
Why does my credit balance look lower while a build is running?
When a build starts, credits are held temporarily while the activity is in progress. Your displayed balance reflects your total minus any held credits, so it may appear lower than expected until the build finishes. If the build succeeds, the held credits become the actual charge. If the build fails, the held credits are released back to your account.
Where can I see my credit transaction history?
Go to Profile avatar → Credit usage. This shows your balance, recent transactions, and credit sources. AI image generation charges appear as Image Generation in the transaction list. Live canister maintenance top-ups appear as a separate line item and are billed proportionally to the resources deposited.
Why do I see small credit charges for my live app even when I am not building?
Live apps require compute resources to stay running on the Internet Computer network. Caffeine automatically tops these up as needed and charges proportionally to the amount deposited — you pay only for what your app actually uses.
What is a subscription voucher?
A subscription voucher is a special code that activates a paid subscription for a fixed period — for example, 1 month of Host or 3 months of Studio — at no charge. Unlike a credit voucher, it does not add credits directly; instead it starts a subscription that gives you the full credit allowance and premium features of the chosen plan for the duration. The subscription ends automatically when the period runs out unless you choose to renew it.
Can I redeem a subscription voucher if I already have an active subscription?
No. Subscription vouchers can only be applied when your account does not already have an active paid subscription. If you are already subscribed, the voucher cannot be redeemed until after your current subscription ends.
What happens when a subscription voucher expires?
When the voucher-granted subscription period ends, your account automatically reverts to the Free plan. Your apps and data are not affected, but paid-plan features no longer apply.
Am I charged credits when a build fails?
No. Credits held at the start of a build are released back to your account automatically — no further action is needed on your side.
Am I charged credits if I don't like what the AI built?
Yes. Credits are released back when a build fails — not when you are unhappy with the output of a successful build. If the build completed and produced working code, those credits are spent.
Am I charged for Go Live if deployment fails?
It depends on how far deployment got. If Go Live could not start after you clicked the button, deployment credits are released back automatically — no further action is needed on your side. If you see a Go live failed message, the Go Live charge typically still applies. Check Profile avatar → Credit usage and use Profile avatar → Get help if the charge looks wrong.