Start here
Codebase
ZShip project structure: core apps and backend services.
Last updated Mar 22, 2026
This page describes the core delivery structure: apps/web, apps/admin, and the 10 backend Workers.
Core directory layout
zship/
├── apps/
│ ├── web/ # User-facing site (Astro + Vue)
│ └── admin/ # Admin console (Nuxt 4 + Nuxt UI)
├── backend/
│ ├── node1-auth-service/ # Auth, users, credits, API keys
│ ├── node2-support-service/ # Tickets, email, feedback
│ ├── node3-pay-service/ # Payments, pricing, webhooks
│ ├── node4-notify-service/ # Bark, Feishu, DingTalk
│ ├── node5-blog-service/ # Blog CMS
│ ├── node6-cdn-service/ # File upload, CDN
│ ├── node7-site-service/ # Banners, friend links, waitlist
│ ├── node8-prompt-service/ # Prompt library
│ ├── node9-checkin-service/ # Check-in rules, rewards
│ └── node10-ai-service/ # AI gateway, chat, sessions
├── packages/ # Shared packages (used by core delivery)
│ ├── dashboard/ # Dashboard components, brand config
│ ├── backend-utils/ # Worker / admin utilities
│ ├── blog-engine/ # Blog markdown pipeline
│ ├── notify-utils/ # Notification helpers
│ └── nuxt-admin-layer/ # Admin Nuxt layer
└── scripts/ # Dev Console, deploy scripts

Backend services (core)
| Service | Directory | Role |
|---|---|---|
| Auth | node1-auth-service |
Login, register, users, credits, API keys |
| Support | node2-support-service |
Tickets, feedback, email |
| Pay | node3-pay-service |
Stripe, Creem, pricing, webhooks |
| Notify | node4-notify-service |
Push notifications |
| Blog | node5-blog-service |
Blog CMS |
| CDN | node6-cdn-service |
File upload, storage |
| Site | node7-site-service |
Banners, friend links, waitlist |
| Prompt | node8-prompt-service |
Prompt templates |
| Check-in | node9-checkin-service |
Check-in rules, rewards |
| AI | node10-ai-service |
AI gateway, multi-model chat |
Value-added (not in core)
zship-provider1-service— AI provider gateway (KIE, WaveSpeed AI), purchasable separatelyapps/landing,apps/web-nuxt— Optional marketing / alternate frontends
Next steps
- Deployment Guide — Deploy core stack
