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. 🚀