Home

Welcome to the ShipNext documentation. The docs are organized in the order you will usually need them: get the app running, configure the product, then connect third-party services.

Recommended reading order

1. Installation - Install dependencies, copy environment variables, and start the development server.
2. Quick launch - Use the minimum configuration to verify auth, the database, Dashboard, pricing, and docs.
3. Project structure - Understand the responsibilities of app, modules, core, integrations, shared, and content directories.
4. Website configuration - Update brand, auth, payments, notifications, email, docs, and legal page switches.
5. Environment variables - Configure production URLs, auth secrets, database, payments, storage, email, and support chat.
6. Internationalization - Understand locale routing, copy loading, language switching, and hreflang.

Common integrations

• Database - SQLite by default, with PostgreSQL switching notes.
• Authentication - Better Auth, email/password, OAuth, magic links, and captcha.
• Email - Resend plus React Email transactional templates.
• Stripe - Default payment provider, Price IDs, Checkout, Portal, and test boundaries.
• Payment webhooks - Subscriptions, orders, entitlement grants, and idempotent processing.
• Storage - S3-compatible object storage, browser multipart upload, and usage tracking.
• Captcha - Turnstile, reCAPTCHA, hCaptcha, and Better Auth request checks.
• Newsletter - Manage subscription status with Resend Contacts.

Current implementation boundaries

These docs describe the repository as it exists now: English is the default docs language, Chinese is also available, SQLite is the default database, Stripe is the default payment provider, and the project uses Next.js 16. When a document calls out a missing or suggested implementation detail, it is marked as a follow-up instead of assuming the feature already exists.