stripekit

Using stripekit

stripekit is a CLI that (1) reconciles a declarative stripe.config.ts into the user's own Stripe account and (2) scaffolds correct billing code into a Next.js App Router app. It's plain Stripe underneath — no hosted service, no runtime dependency.

Install-free: every command runs via npx stripekit@latest <command>. Always check npm for the latest version.

Prerequisites

• Node.js 20+.
• A Stripe test secret key (sk_test_…) available as STRIPE_SECRET_KEY in the environment or .env.local. Never enter real keys on the user's behalf — ask them to add it.

Full setup in a Next.js app

1. npx stripekit@latest init — detects the framework + auth library, writes stripe.config.ts, and scaffolds lib/stripe/* (client, sync, customer helpers, storage adapter) and app/api/stripe/* (webhook, checkout, portal). Flags: --adapter kv|drizzle, --auth clerk|authjs|better-auth|none, --yes.
2. Edit stripe.config.ts to define products, prices, and features.
3. npx stripekit plan — preview what will change on the Stripe account (read-only).
4. npx stripekit push — create/update products, prices, webhook endpoint, and portal; writes STRIPE_WEBHOOK_SECRET and STRIPE_PORTAL_CONFIGURATION_ID back to .env.local.
5. npx stripekit dev — forward Stripe webhooks to localhost during development (wraps stripe listen).
6. npx stripekit check — verify keys, config, drift, and webhook/portal wiring.

Any stack (catalog only)

Running init in a non-Next.js project sets up only stripe.config.ts. Use plan / push / pull to manage the catalog from any stack.

Config shape

import { defineConfig } from 'stripekit'

export default defineConfig({
  products: {
    pro: {
      name: 'Pro',
      prices: {
        monthly: { amount: 2000, currency: 'usd', interval: 'month' }, // amount in cents
        yearly: { amount: 19200, currency: 'usd', interval: 'year' },
      },
      features: { seats: 5, projects: 'unlimited' },
    },
  },
  portal: { cancellations: true, planSwitching: true },
  webhooks: { path: '/api/stripe/webhook' },
})