Docs

Getting started

Set up the starter locally, configure providers, and verify the launch path.

VibeShip is the template. This live site is also a demo product: its pricing page shows example subscriptions used by the demo checkout, not a template licence or price. Start with the getting-started guide; licensing questions go to contact.

1. Set identity

Update the metadata in lib/app-config.ts first. Product name, pricing, support email, and provider defaults should change before copy polishing.

Then rewrite DESIGN.md so the repo reflects your visual system instead of inheriting the starter's taste.

2. Choose providers

NextAuth accounts (GitHub/Google OAuth, or Cloudflare Email links and one-time codes) and Stripe subscriptions are the implemented adapters. The database is Cloudflare D1 through Prisma; there is no PostgreSQL runtime or Resend adapter.

Other provider labels in the original config are extension points, not working adapters. Keep live mode off until you have the keys, callbacks, webhooks and a local workflow to verify them. AI execution is an optional OpenAI-compatible module configured with AI_BASE_URL, AI_API_KEY and AI_MODEL.

3. Ship the first path

Do not expand before one user path works. Marketing page, login or signup, pricing, and one value-producing app surface should be enough for the first release.

4. Verify, do not assume

Run npm run doctor for configuration presence without printing secrets, then follow docs/VERIFICATION.md. A local build, preview session or green doctor result never proves OAuth, email delivery, a Stripe payment or a live AI request.