# vibestrap

> A paid, AI-native Next.js scaffold for indie hackers. Auth, payments, i18n,
> credits, mail, content, marketing — wired and ready. Drop into Claude
> Code / Cursor / Windsurf and ship in a few prompts.

## Overview

- Stack: Next.js 15.5, React 19, TypeScript 5.9, Tailwind 4, shadcn/ui,
  Drizzle + Postgres, Better Auth, next-intl (en + zh), Resend, Fumadocs.
- Payments: Stripe, Creem, NOWPayments (crypto). Subscriptions + one-time
  + credit-pack pricing patterns.
- Analytics: Vercel, GA4, PostHog, Plausible, Umami, MS Clarity, OpenPanel.
- License: commercial — buy at https://vibestrap.dev/pricing.

## For AI agents

Read [AGENTS.md](https://github.com/xiaohu0x/vibestrap/blob/main/AGENTS.md)
first. It contains the project map, conventions, and ready-made prompts
for the most common buyer customizations (re-skin, change pricing, add
locale, add payment provider, add admin page, add plan tier).

## Key links

- Marketing site: https://vibestrap.dev
- Pricing: https://vibestrap.dev/pricing
- Docs: https://docs.vibestrap.dev
- GitHub: https://github.com/xiaohu0x/vibestrap
- Design doc: https://github.com/xiaohu0x/vibestrap/blob/main/internal-plans/2026-04-27-vibestrap-design.md

## Where things live

- `src/config/site.ts` — central config (site name, links, pricing, providers).
- `src/app/[locale]/(marketing)/` — public pages.
- `src/app/[locale]/(app)/` — authed pages (settings, admin).
- `src/payment/` — provider facade + Stripe/Creem/NOWPayments adapters.
- `src/credits/` — atomic credits ledger (GRANT/CONSUME/EXPIRE/REFUND).
- `src/db/` — Drizzle schemas (`auth.schema.ts`, `app.schema.ts`).
- `messages/{en,zh}.json` — bilingual i18n strings.
- `content/{blog,changelog}/*.mdx` — marketing content.
- `docs/` — Fumadocs source (served at docs.vibestrap.dev).
- `k8s/` — production K8s manifest + secret bootstrap.

## Common buyer customizations

| Goal | Files to touch |
|------|---------------|
| Change brand name / colors | `src/config/site.ts`, `src/app/globals.css` |
| Change pricing | `src/config/site.ts` (`product` + `demoPlans`) |
| Add a locale | `src/i18n/routing.ts`, `messages/<locale>.json`, `*.<locale>.mdx` |
| Customize emails | `src/mail/templates/*.tsx` |
| Add payment provider | `src/payment/provider/<name>.ts` + facade + webhook route |
| Add admin page | `src/app/[locale]/(app)/admin/<slug>/page.tsx` |

## Verification

```bash
pnpm typecheck && pnpm lint && pnpm build
```