AI Club Cambodia

✅ Rule 1: Use process.env.PORT — never hardcode a port (3000, 8080, etc). The platform assigns the port.

✅ Rule 2: Have package.json with a start script. The platform runs npm start.

✅ Rule 3: Bind to process.env.HOST (127.0.0.1). Caddy handles public HTTPS.

// ✅ Correct app.listen(process.env.PORT, process.env.HOST); // ❌ Wrong — hardcoded port, will crash app.listen(3000);

✅ Rule 4: Store user uploads (images, PDFs) in process.env.STORAGE_PATH — a persistent dir the platform gives every app. The code directory is WIPED on every deploy; STORAGE_PATH survives redeploys.

// ✅ Correct — uploads persist across deploys const STORAGE = process.env.STORAGE_PATH; app.use('/uploads', express.static(STORAGE)); const upload = multer({ destination: STORAGE }); // ❌ Wrong — wiped on the next deploy app.use('/uploads', express.static('./uploads'));

Auto-injected env: PORT, HOST, NODE_ENV, DATABASE_URL, APP_BASE_URL, STORAGE_PATH — do not set these.
Package managers: npm, pnpm, yarn — auto-detected from lockfile.
Frameworks: Express (no build), Next.js/Nuxt (set build_command: npm run build).
Deploy: tell your agent "Deploy to AIC-Web as [name]" or upload a zip via the portal.
Full guide: /deploy-guide