Bunship Documentation

Bunship is a production-oriented AI SaaS full-stack template with built-in business integrations.

What is Bunship?

Bunship is a full-stack starter for AI SaaS products. It is built to help you ship real business flows quickly, instead of assembling infrastructure from scratch.

Built-in capabilities include:

Auth and OAuth
Wallet, subscriptions, dual-bucket credits, and Stripe sync
Affiliate invitations and withdrawal review
AI image generation pipeline with queue and credit deduction
S3-compatible storage
CMS + admin operations console
Integrated Fumadocs docs system

Tech Stack

Next.js 16

Unified frontend runtime for marketing, app, admin, and docs routes.

Elysia API

Business API layer for wallet, subscription, order, affiliate, AI, and CMS capabilities.

Postgres + Drizzle

Type-safe data schema and migrations.

Auth Providers

Better Auth (default) or Clerk with user sync.

Stripe

Subscription billing and renewal-driven credit grants.

AI Providers

Multi-provider model access with queue and pricing controls.

UI & Blocks

Shared UI system and reusable marketing blocks.

Fumadocs

Built-in docs center with search and MDX support.

Resend

Verification, OTP, and reset-password email delivery.

next-intl

Locale routing and translation management.

next-safe-action

Type-safe server action validation.

Scope of This Documentation

This docs center focuses on Bunship implementation details (not framework basics):

integration responsibilities, flows, and schema boundaries
key extension points and customization entry points
deployment and operations checklists
integration pitfalls and production notes

Official Documentation

Next.js: https://nextjs.org/docs
Elysia: https://elysiajs.com
Drizzle: https://orm.drizzle.team/docs/overview
Better Auth: https://www.better-auth.com/docs/introduction
Clerk: https://clerk.com/docs
Stripe: https://docs.stripe.com
Fumadocs: https://www.fumadocs.dev/docs/ui

Getting Help

If you're stuck, here are some ways to get help:

Next Steps

Quick Start

Run the project locally and verify core flows.

Architecture

Understand runtime topology and boundaries.

Integrations Overview

See all capabilities first, then go deep by scenario.

Wallet & Subscription

Learn credit buckets, monthly reset, and deduction order.

Introduction