The capsule — starting a full-stack app, not just hosting one
A one-command starter with a provisioned database, sign-in, realtime, and managed AI already wired, so your assistant builds on a working app instead of an empty folder.
Most of what Percher does is host an app you already have. The capsule template is the other direction: it hands your assistant a working full-stack app to start from.
The problem it solves is the blank folder. Ask an assistant to "build a full-stack app with a database and login" and it faces a dozen decisions before it writes a line of feature code: which database, how migrations run, where auth lives, how the client talks to the server, how secrets get in. Each one is a place to guess wrong. And you often don't find out until the deploy fails or the login silently doesn't work.
The capsule makes those decisions ahead of time. One command scaffolds the app:
bunx percher create my-app --template capsule
bunx percher publishWhat comes up is a real app, not a skeleton. A PocketBase database whose schema Percher provisions before the container goes live, so the tables exist on the first request rather than after a migration you forgot to run. Email-and-password sign-in, with Google a single percher data oauth google away. Realtime subscriptions. A typed database client. And, on a paid plan, managed inference in src/lib/ai.ts — with no API key to paste.
From there it's the normal loop. You describe a feature, your assistant edits the capsule and republishes, and the schema, auth, and AI are already there to build against. It's the difference between "wire up a database" and "add a table" — the first is where assistants stall, the second is where they're good.
Two honest edges. The capsule is for starting something new; if you already have an app, the framework detection in percher init is the path, not this. And the database is PocketBase — SQLite with auth and file storage in one container. It's the right shape for the apps the capsule is for, but not a drop-in for Postgres. If you need Postgres, point DATABASE_URL at one you run.
That's the whole idea. Your assistant is good at building on something that works and worse at assembling the foundation. The capsule is the foundation, provisioned and live, so the building can start on the first prompt.