Deployment Overview

Manacore uses multiple deployment strategies depending on the application type.

Deployment Targets

Cloudflare Pages

Static sites: Landing pages, documentation

Mac Mini Server

Docker containers: Backends, databases

Hetzner Storage

S3-compatible object storage for files

Application Types

Type	Deployment Target	Method
Landing Pages (Astro)	Cloudflare Pages	Direct Upload
Web Apps (SvelteKit)	Cloudflare Pages	Adapter
Backends (NestJS)	Mac Mini / Docker	Docker Compose
Databases	Mac Mini / Docker	Docker Compose
Static Assets	Hetzner S3	Direct Upload

Infrastructure Overview

┌─────────────────────────────────────────────────────────────┐
│                    Cloudflare                                │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │ chat.mana   │  │ docs.mana   │  │ picture.mana│   ...   │
│  │   core.app  │  │   core.app  │  │   core.app  │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          │                                  │
│              Cloudflare Tunnel                              │
└──────────────────────────┼──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                    Mac Mini Server                           │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │ mana-core-  │  │ chat-       │  │ zitare-     │   ...   │
│  │ auth:3001   │  │ backend:3002│  │ backend:3007│         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          ▼                                  │
│  ┌─────────────────────────────────────────────────┐       │
│  │  PostgreSQL:5432  │  Redis:6379  │  MinIO:9000  │       │
│  └─────────────────────────────────────────────────┘       │
└─────────────────────────────────────────────────────────────┘

Deployment Commands

Landing Pages

# Deploy individual landing page
pnpm deploy:landing:chat
pnpm deploy:landing:picture
pnpm deploy:landing:zitare

# Deploy all landing pages
pnpm deploy:landing:all

Documentation

# Deploy documentation site
pnpm deploy:docs

Backends (via SSH)

# Connect to server
ssh mana-server

# Pull latest changes
cd ~/projects/manacore-monorepo
git pull

# Restart services
./scripts/mac-mini/deploy.sh

Environments

Environment	Purpose	URL Pattern
Development	Local testing	`localhost:*`
Staging	Pre-production testing	`staging.*.manacore.app`
Production	Live users	`*.manacore.app`

CI/CD

Planned Pipeline

On PR: Run tests, type-check, lint
On merge to main: Deploy to staging
On release tag: Deploy to production

Rollback Procedures

Cloudflare Pages

# View deployments
npx wrangler pages deployment list --project-name=chat-landing

# Rollback to previous
npx wrangler pages deployment tail <deployment-id> --project-name=chat-landing

Docker Services

ssh mana-server
cd ~/projects/manacore-monorepo

# Revert to previous commit
git checkout HEAD~1

# Rebuild and restart
./scripts/mac-mini/deploy.sh

Next Steps

Cloudflare Pages - Static site deployment
Mac Mini Server - Backend deployment
Self-Hosting - Host your own instance