Introduction

What is ZShip?

ZShip is a production-ready, full-stack AI SaaS template that runs entirely on Cloudflare’s global edge network.

Out of the box, you get 2 frontend apps and 10+ backend microservices — everything you need to launch an AI SaaS product:

Frontend Apps

App	Tech Stack	Description
apps/web	Astro 5 + Vue + Tailwind CSS	User-facing website — landing pages, pricing, auth, user dashboard
apps/admin	Nuxt 3 + Element Plus	Admin console — manage users, payments, AI models, content, and operations

Backend Microservices (Cloudflare Workers + Hono + D1)

Service	Description
node1-auth-service	Authentication, sessions, OAuth, email verification
node2-support-service	Tickets, feedback, email records
node3-pay-service	Payments (Stripe/Creem), pricing, credits, webhook audit
node4-notify-service	Push notifications (Bark / Feishu / DingTalk)
node5-blog-service	Blog content management
node6-cdn-service	Object storage and file distribution (R2)
node7-site-service	Site config, banners, waitlist
node8-prompt-service	Prompt library and copy tracking
node9-checkin-service	Check-in rules and streak rewards
node10-ai-service	AI Gateway, multi-model routing, conversation and billing
zship-core-service	Core API gateway

---

Why ZShip?

Building an AI SaaS from scratch means stitching together auth, payments, AI integration, notifications, admin panel, and deployment — that takes months.

ZShip exists to compress that timeline to days:

• Complete out of the box — Auth (JWT + Google OAuth), payments (Stripe), AI gateway (multi-model LLM), check-in rewards, notifications, and admin panel are all built-in. No need to start from zero.
• Multi-tenant by design — Every service isolates data via app_key, so you can run multiple products on one deployment.
• Edge-native architecture — Every service is a Cloudflare Worker, every database is D1/KV/R2. Global deployment with zero infrastructure management.
• Independently evolvable — Frontend and backend are decoupled into separate packages. Swap Astro for Next.js, or scale a single service — without touching the rest.
• Ops-ready from day one — Built-in admin console with user management, payment config, model toggles, content publishing, and audit logs.

---

Quick Start (5 Minutes)

Prerequisites

• Node.js ≥ 18
• pnpm ≥ 10
• A Cloudflare account (for D1, KV, R2, Workers)

1. Clone and install

git clone https://github.com/your-org/zship.git
cd zship
pnpm install

2. Initialize local databases

pnpm db:migrate:local
pnpm db:migrate:support:local

3. Start developing

Use the built-in DevConsole to launch all services with one click:

pnpm dev:console

Or start individual services manually:

# Frontend — User site (http://localhost:4321)
pnpm dev:web

# Frontend — Admin console (http://localhost:3100)
pnpm dev:admin

# Backend — Auth service
pnpm dev:auth

# Backend — Core API gateway
pnpm dev:core

4. Deploy to Cloudflare

# Deploy a backend service
pnpm deploy:auth
pnpm deploy:core

# Build frontend for Cloudflare Pages
pnpm build:web
pnpm build:admin

You now have a fully functional AI SaaS running on Cloudflare’s edge. 🚀