Runtime matrix

What the platform supports — spelled out before build

Project types PocketBay supports today, plus Node.js/Python versions, package managers, start conventions, and static hosting limits.

Node.js projects

Supports npm, pnpm, and Yarn. The platform reads the packageManager field first, then infers from lockfiles; installs prefer deterministic lockfile mode, with warnings and compatible fallback when lockfiles are out of sync.

Start command priority: scripts.start, main field, then common entry files. If start cannot be determined, a structured error is returned before Docker build.

Python projects

Supports common dependency declarations in requirements.txt, pyproject.toml, uv.lock, Poetry, and Pipenv. FastAPI scans common ASGI apps; Flask and Django get compatible start plans from dependencies and entry points.

Static sites

Pure static projects are served directly by Caddy file_server with no always-on container. Default limits per deploy: 200MB, 5,000 files, keeping the latest 3 immutable version directories.

Custom Dockerfile

PocketBay respects your Dockerfile and does not override its build. This mode still suits single-container web services only; other services in Docker Compose are not started automatically.