| name | xianwen-deploy |
| description | Xianwen Online full deployment workflow: commit, push, build, deploy server (Hetzner SSH) + web client (GitHub Pages) + itch.io, release versioning, CI/CD fix. Use when user says 'deploy', 'commit/push', 'release', '進版', '部署'. |
Xianwen Deploy Workflow
Complete deployment pipeline for Xianwen Online, extracted from 999+ development sessions.
Deployment Targets
| Target | Method | URL |
|---|
| Server (Rust) | SSH to Hetzner VPS → docker compose build && up | 5.223.42.8 |
| Web Client (Vue) | GitHub Actions → GitHub Pages | play.xianwen.online |
| Desktop (Tauri) | GitHub Actions → itch.io release | DuDuStudio on itch.io |
CRITICAL: No GHCR
NEVER use GHCR Docker push. Always SSH directly to Hetzner and build on the server.
Standard Deploy Flow
1. Pre-deploy Checks
cd server && cargo check && cargo clippy && cargo fmt --check
cd web-client && pnpm run build:web
2. Commit & Push
git add <specific-files>
git commit -m "<type>: <description>"
git push origin main
3. Deploy Server
ssh root@5.223.42.8 "cd /opt/xianwen-online && git pull && docker compose build && docker compose up -d"
4. Deploy Web Client