Getting Started with ShipAny

ShipAny is a powerful Next.js 15 boilerplate designed to help you launch your AI SaaS product quickly. This guide will walk you through the essential features and setup process.

Key Features

• Next.js 15 with App Router and Turbopack for blazing-fast development
• • Authentication ready with Google, GitHub, and One-Tap sign-in
• • Payment Integration with Stripe and Creem support
• • Internationalization supporting English and Chinese out of the box
• • AI SDK Integration with multiple providers (OpenAI, DeepSeek, Replicate)

• Quick Setup

• 1. Clone the repository
• 2. Copy .env.example to .env.development
• 3. Configure your database and authentication providers
• 4. Run pnpm install and pnpm dev

• Database Setup

• ShipAny uses Drizzle ORM with PostgreSQL:

• Generate migrations

• pnpm db:generate

• Run migrations

• pnpm db:migrate

• Open database GUI

• pnpm db:studio

• Adding AI Features

• The template comes with AI SDK integrations ready to use:
• import { openai } from '@/aisdk/provider/openai';
• const completion = await openai.chat.completions.create({
• model: 'gpt-4',
• messages: [{ role: 'user', content: 'Hello!' }],
• });

• Deployment

• Deploy to Vercel with one click, or use the included Docker configuration for self-hosting.

• Vercel Deployment

• • Click the "Deploy with Vercel" button
• • Configure environment variables
• • Push to deploy automatically

• Docker Deployment

• pnpm docker:build

• Customization

• • Theme: Edit src/app/theme.css or use the visual editor at tweakcn.com
• • Landing Page: Modify JSON files in src/i18n/pages/landing/
• • Pricing: Configure plans in the pricing JSON files

• Credits System

• ShipAny includes a built-in credits system for monetizing AI features:
• • Credits are automatically added after payment
• • Deduct credits for AI API usage
• • Track user consumption in the admin panel

• Admin Dashboard

• Access the admin panel at /admin to manage:
• • Users and their credits
• • Orders and payments
• • Blog posts and categories
• • User feedback

• Next Steps

• Now that you have ShipAny set up, you can:
• 1. Customize the landing page content
• 2. Configure your payment provider
• 3. Set up AI integrations
• 4. Deploy to production
• Happy building!