guide

Your apps

One Gemmein account, as many apps as its plan allows. Create one for each idea, rename any of them, switch between them, and delete one you've stopped using — for good.

Many apps on one account

How many apps an account holds follows its plan, never the app: free holds 3, all Development-only (none of the three can go live without a plan); paying for any plan — on any one of them — raises the whole account to that plan's own number: Launch 5, Run a business 10, Grow 25. One plan covers the account and every app on it, however many of them are live. A lapsed plan keeps every app you already have, but pauses every one of them — every write is refused until the card is updated — and holds no new ones until it's active again. The app switcher in the dashboard's top bar moves between them; each keeps its own Development and Live, and its own data.

Your AI's create_app asks you to approve a new one in your browser, with the code Gemmein emails.
Settings → General renames the app, or deletes it (below).
An account past its limit is refused 409 app_limit_reached; delete an app you've stopped using, move the account up a tier on Usage, or write to Gemmein once you're already on Grow.

Delete an app

What it is. Permanent erasure of one app, on both Development and Live. There is no undo, and no recovery window.

What it does, in order.

Disappears at once. The app answers as gone from the very first step, on every surface, before anything else has run.
Stripe. Every active customer subscription, in both environments, is cancelled in Stripe at once — no refund by Gemmein. The Payment Links and the webhook endpoint Gemmein made for this app are turned off. Your own connected Stripe account, and its payment history, are untouched.
Everything outside your data. Deployed Edge functions, your domains and their sender half, and the site with its files.
Every record. Every customer, record, file, relay, AI tool and key the app owns.
One line stays. A single deletion record survives, under Settings → General → Deleted apps: who deleted it, when, and what went with it — "This deletes 42 customers, 1,203 records, 58 files… and 1 active subscription," then, once it has run, "Acme was deleted permanently. Deleted with it: 42 customers, 1,203 records… One subscription was cancelled in Stripe."

Three ways to ask, one deletion underneath.

The dashboard. Settings → General's danger zone shows the real counts first, then asks you to type the app's exact name and confirm with the code Gemmein emails (and your authenticator code too, if you have one) — even for a Development-only app that has never gone live.
Your AI. delete_app asks you to approve it in your browser. The approval page shows the same real counts, and asks for the same typed name and the same two codes.
npx gemmein apps delete. Opens the identical browser approval — the CLI never collects the name or a code itself.

What it does not do.

Undo. Once the typed name and the codes are confirmed, it runs.
Touch any other app on the account.
Delete your own Stripe account's payment history, or anything else outside this app.
Stop your Gemmein plan. The plan belongs to the account, not the app, and keeps running and billing — even once it was your last app. Cancel or change it on Usage → Manage billing.

When you need something else.

To delete one person's account rather than the whole app: Account deletion.

Example. A side project you've moved on from: delete it, and its slot opens up for a new one.

What happens if…

If…	What happens	What you do
The typed name doesn't match the app's current name, exactly	`400 name_mismatch`; nothing is deleted and no code is spent, on any path; the request stays open to try again	Type the name again
It's the last app on the account	Deleted the same way as any other; the account goes back to holding none, and a new one can be made the same way as the first. Your Gemmein plan, if you have one, keeps running and billing — it belongs to the account, not the app	Cancel or change the plan on Usage → Manage billing, if you want to
A subscription's cancellation hasn't been confirmed by Stripe yet	The app is already gone from every surface, and the Edge functions, domains and site are already removed — but your app's data (every customer, record, file, relay, AI tool and key) is erased only once Stripe confirms. The dashboard, your AI and the CLI all say so plainly, by the end of its Stripe id. Gemmein retries after 15 minutes, then less often, at least every 6 hours	Wait, or cancel it yourself in your Stripe dashboard
Gemmein can no longer reach your Stripe account by the time it finishes	The deletion finishes anyway; the one surviving record, and a 30-day notice on Home, the app switcher, your AI's `app_status` and the CLI's `apps`, name what may still be active there	Check and cancel it in your own Stripe dashboard
A deletion is interrupted midway — a crash or a restart	Gemmein picks it up again within 30 minutes and finishes what is left; the app stays gone the whole time, and a step already done changes nothing the second time	Nothing
Another tab is still open on the app when it's deleted	Its next request lands on "This app isn't here any more," with Go to your apps, or Create my app if it was the last one	Nothing
The account was at its plan's app limit	Deleting one frees a slot at once	Nothing

Was this page helpful?

Last updated 4 November 2026