Docs/Start here
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

ZShip Admin — projects & sites

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 separately
  • apps/landing, apps/web-nuxt — Optional marketing / alternate frontends

Next steps