# NanoShip

> NanoShip is a production-ready Next.js 15 and Cloudflare starter template. It ships with Google auth (NextAuth v5), a credit ledger, a Stripe payment skeleton, a streaming AI chat module (Replicate and OpenRouter), Cloudflare-native storage (D1, KV, R2, and Durable Objects via OpenNext), next-intl i18n, light and dark theming, and a minimal server-first Simple component system. Site: https://nanoship.dev

## What NanoShip is

NanoShip is a starter template for developers who want to ship a SaaS product on Next.js and Cloudflare without wiring up every piece from scratch. It provides a working application with auth, credits, payments, an AI chat module, and a component system, all deployed to Cloudflare Workers via OpenNext.

The template is designed to be cloned, rebranded with one command (the ship skill), and deployed. Every module is self-contained so you can delete what you do not need without breaking the rest.

## Included modules

**Google auth:** NextAuth v5 with Google sign in, a users table in D1, session handling, and JWT tokens. Ready to extend with additional providers.

**Credit ledger:** A structured credit system with income and expense tables, a history API, and hooks for gating features behind credit balances.

**Stripe skeleton:** A Stripe integration scaffold covering one-time purchases, subscriptions, and webhooks. The product and price catalog is defined in constants and easy to extend.

**AI chat module:** A streaming chat agent that calls Replicate and OpenRouter through the Cloudflare AI SDK. Supports image and video generation. The agent, tools, and system prompt are each in separate files for easy modification.

**Cloudflare-native storage:** D1 for the relational database (Drizzle ORM), KV for fast key-value lookups, R2 for file uploads, and Durable Objects for stateful throttling and prediction tracking. All wired through OpenNext so they work the same in local dev and production.

**next-intl i18n:** Route-based internationalization with locale-aware URLs, a translation message file per locale, and content files that separate page copy from interactive strings.

**CSS theme system:** Light and dark themes via Tailwind CSS v4 and CSS custom properties. Theme state is persisted to localStorage and managed through a React context with a toggle component.

**Simple UI kit:** A small set of server-first React components for fast pages: SimpleHero, SimpleFeatures, SimpleSteps, SimpleStatistics, SimpleFAQ, SimpleLinkCards, SimpleChangelog, and SimpleBreadcrumb.

## The five starter pages

- Home (/): hero with CTAs, features, steps, statistics, FAQ, and link cards.
- Changelog (/changelog): versioned release history rendered from a structured list.
- Support (/support): a contact and feedback form with a FAQ section.
- FAQ (/faq): quick facts and detailed questions and answers about the template.
- Privacy Policy (/privacy) and Terms of Service (/terms): markdown-rendered legal pages.

## Setup

1. Clone the repository and run pnpm install.
2. Run the ship skill to set your brand name, domain, and environment keys.
3. Run pnpm dev to start the local development server.
4. Run pnpm d1:apply to apply database migrations locally.
5. Deploy to Cloudflare with pnpm deploy.

## Pages

- Home: https://nanoship.dev/
- Changelog: https://nanoship.dev/changelog
- Support and Feedback: https://nanoship.dev/support
- FAQ: https://nanoship.dev/faq
- Privacy Policy: https://nanoship.dev/privacy
- Terms of Service: https://nanoship.dev/terms