CreditKit
Next.js, Supabase, and Stripe starter template with a real usage credits system for AI apps
Gallery
About CreditKit
CreditKit is a starter template for developers building AI applications that need to charge users based on consumption. It handles the billing infrastructure that most pay-per-use products require: credits that get deducted when you call an API, refunds when something fails, and webhook handling that doesn't accidentally double-charge anyone. If you've ever tried to roll your own usage-based billing, you know how many edge cases live in that code. CreditKit packages the hard parts so you can focus on the AI instead of the payment plumbing. It's the kind of unglamorous infrastructure work that's easy to underestimate until you're debugging webhook race conditions at midnight wondering why a customer got charged three times.
The stack is Next.js on the frontend, Supabase for the backend and authentication, and Stripe for payments. That's a common combination for indie developers and small teams shipping fast, and the template fits cleanly into that workflow. You're not adopting a proprietary platform. You get full source code that you own outright, no ongoing licensing fees, no lock-in. It's a one-time purchase and then the code is yours to modify however you want. If you need to customize the billing logic for a specific use case, you can. If you want to rip out Stripe and replace it with something else, you have the source to do that. Ownership matters when you're building something you plan to run for years. You don't want to depend on a billing SaaS that might change its pricing or shut down.
A few implementation details stand out. Credit spend is atomic, meaning transactions either complete fully or roll back, which prevents the partial-deduction bugs that haunt poorly-built billing systems. If the AI call fails halfway through, you don't end up with a user who got charged but didn't get the result. That sounds like an obvious requirement, but it's surprisingly easy to get wrong when you're wiring up a database, a payment processor, and an external API all at once. Stripe webhooks are idempotent, so if the same event fires twice, you don't charge the user twice. This sounds obvious until you've seen the alternative: duplicate charges, customer complaints, manual refunds, support tickets that eat your whole afternoon. Getting idempotency right from the start saves a lot of pain down the road. And there's a background worker that monitors jobs and automatically refunds credits when something fails. These aren't glamorous features, but they're exactly the kind of thing that breaks at scale if you don't get them right from the beginning.
CreditKit is aimed at solo developers and small teams building AI wrappers, chatbots, image generators, transcription services, or any tool where users pay per request rather than per month. The template saves you the weeks you'd otherwise spend wiring up Stripe, handling webhooks defensively, and building a credits ledger that actually stays consistent under load. Most developers underestimate how long this takes because it looks simple on the surface. You think you can knock it out in a weekend. Then you hit the edge cases: what happens when a webhook arrives before the database write completes, what happens when a user triggers multiple jobs in quick succession, what happens when the AI provider times out but eventually returns a result. CreditKit has answers for those questions built in, which means you don't have to discover them the hard way in production.
The price is $129 as a one-time purchase through Gumroad. That's cheap compared to the engineering hours it replaces, especially if you've priced out what it costs to build and test this stuff yourself. A single day of developer time often costs more than the template, and billing code takes more than a day to get right. There's no free tier, but you get the full source immediately and can evaluate whether it fits your needs. If you're serious about shipping a usage-based AI product and don't want to reinvent billing, this is a solid shortcut that gets you to launch faster. The time you save goes directly into the parts of your product that actually differentiate you.
The main limitation is scope. CreditKit solves billing and credits, not authentication, rate limiting, infrastructure deployment, or AI provider integrations. It assumes you're already comfortable with the Next.js and Supabase stack and just need the billing layer handled. If you need a more opinionated full-stack boilerplate that handles everything from auth to deployment, you'll want something broader. But for the narrow problem of credits-based billing with proper webhook handling and automatic refunds, this does the job cleanly. It's a focused solution for a focused problem, and that's usually what you want in a template: something that solves one thing well rather than trying to solve everything mediocrely. Better to compose multiple focused tools than to rely on one bloated boilerplate that does everything poorly.
Key Features
- Atomic credit spend transactions
- Idempotent Stripe webhook handling
- Background worker for failed job refunds
- Full source code ownership
- Next.js and Supabase integration
- Usage based billing out of the box
Pros & Cons
What we like
- Solves the hardest parts of usage billing upfront
- You own the code outright with no ongoing fees
- Built on a modern stack most developers already know
- Handles edge cases like failed transactions and webhook retries
Room for improvement
- One time cost may feel steep for hobbyist projects
- Requires familiarity with Next.js and Supabase
- Focused only on billing, not a full SaaS template
- No hosted option if you prefer managed services
Frequently Asked Questions
What is CreditKit?
How much does CreditKit cost?
Who is CreditKit for?
What tech stack does CreditKit use?
Best For
Featured in
Alternatives to CreditKit
View all
1Lookup
Real-time data verification API for phone, email, IP, and domain validation to fight fraud
Kevin Gabeci
Solo developer building web apps, cozy browser games, and AI creator toolkits.

Codedex
A gamified, story-driven platform that teaches Python, web dev, and more like an RPG quest
Hack2hire
Practice real SDE interview questions from top tech companies with expert worked solutions
Reviews (10)
Does the job, a few gripes
Three months of CreditKit later, here is what holds up. The output quality holds up better than I expected. Mostly using it for charging per api call in a developer product. The catch is one time cost may feel steep for hobbyist projects. Hard to imagine going back to my old setup.
Exactly what I needed
Three months of CreditKit later, here is what holds up. Where it really wins is solves the hardest parts of usage billing upfront. It earns its place in my stack.
Quietly excellent
Three months of CreditKit later, here is what holds up. The full source code ownership is more useful than I expected. It slotted into my routine without much fuss. Found it works best for charging per api call in a developer product. It earns its place in my stack.
Exactly what I needed
Started using CreditKit casually, now it is pinned in my dock. Their take on full source code ownership is genuinely good. Found it works best for adding per generation billing to an ai image tool. Easy yes for anyone weighing the same trade offs.
It just works
Started using CreditKit casually, now it is pinned in my dock. Got real value out of background worker for failed job refunds. No regrets so far.
Finally something that fits
Hadn't planned on switching, but CreditKit was hard to ignore. Their take on next.js and supabase integration is genuinely good. Mostly using it for building a pay per task document processor. Worth it for what I get out of it.
Two months in, no regrets
Found CreditKit on a Show HN thread and I am glad I clicked. Where it really wins is idempotent stripe webhook handling. It handles the boring parts so I can focus on the work that matters. Mostly using it for launching an ai assistant with usage credits. Would sign up again without thinking twice.
Decent with some rough edges
Tried CreditKit on a side project first, then rolled it out everywhere. The interface stays out of my way, which I appreciate. The core workflow is smooth once you are set up. It fits well for charging per api call in a developer product. The catch is requires familiarity with next.js and supabase. Recommending it to people in a similar spot.
Solid daily driver
Tried CreditKit on a side project first, then rolled it out everywhere. What stands out is how it handles atomic credit spend transactions. It does what it says, which is rarer than it should be. It fits well for charging per api call in a developer product. It earns its place in my stack.
Good, with a few caveats
Hadn't planned on switching, but CreditKit was hard to ignore. Their take on full source code ownership is genuinely good. Mostly using it for adding per generation billing to an ai image tool. It would be a five if not for no hosted option if you prefer managed services.
Badge builder
Add CreditKit to your website
Choose a badge style and size, preview it here, then copy the generated HTML. Badge images are self-contained SVGs and do not require an external script.
<a href="https://toolindex.net/tools/creditkit?ref=badge" target="_blank" rel="noopener">
<img src="https://toolindex.net/badge/creditkit/medium.svg" alt="CreditKit - Listed on Tool Index" width="180" height="50" />
</a> How to use the badge
- 1. Pick the style, size, and theme that fit your layout.
- 2. Copy the generated HTML from the code block.
- 3. Paste it into your footer, homepage, or press page.
Standard badge available
The standard listing badge is available now. Score and circle badges are limited to tools currently ranked in the top 10 of a category.
Badge clicks return visitors to this profile with a referral tag so the source remains identifiable.
Related Tools
Kevin Gabeci
Solo developer building web apps, cozy browser games, and AI creator toolkits.

Coolify
Self-hostable, open source alternative to Heroku and Netlify

Warp
The modern terminal reimagined with AI and collaboration

Bolt.new
Prompt-to-deployed full-stack app inside the browser
Work on CreditKit? Request listing access or correction