请将当前项目部署到 PocketBay，部署手册：https://pocketbay.com/deployPre-deploy checklist
- This is a monolithic web project that serves HTTP or static files.
- Node.js projects have a parseable package.json; Python projects have a dependency manifest and web entry.
- Dynamic apps must listen on the PORT env var and bind to 0.0.0.0.
- If using a Dockerfile, the container must start a web service that passes health checks.
- Use a managed PostgreSQL database (provisioned or migrated during AI deploy) or an external connection string when needed. Redis and other engines are not hosted yet.
Full flow
Prepare a runnable web project
The project should be static, nextjs, node, python, or dockerfile, with a clear entry file or build output.
Send the deploy prompt to AI
AI reads project files locally, determines framework_hint, and fetches PocketBay's Agent Markdown manual.
Open the pairing link to confirm
After AI creates a one-time session, it must show you the full auth link; log in to PocketBay and confirm project name and deploy type.
AI packages and uploads
Upload excludes node_modules, .git, .next, virtual envs, and cache dirs to reduce size and leak risk.
Platform generates a build plan
PocketBay analyzes versions, lockfiles, package managers, start commands, and env vars, then runs a constrained build and health check.
Go live or fix from errors
On success you get a pocketbay.app subdomain; on failure AI can read error_category, repair_hint, and logs, fix source, and re-upload.
How deploy type is determined
| Type | Typical project | Key requirements |
|---|---|---|
static | HTML, CSS, JS, or pre-built static output | Includes index.html; served directly by the gateway |
nextjs | Next.js project with next in dependencies | Has build/start scripts; public vars use NEXT_PUBLIC_ |
node | Express, Hono, Koa, and other Node web services | Has a start command and listens on PORT |
python | FastAPI, Flask, Django, and other web services | Has a dependency manifest and recognizable entry |
dockerfile | Custom single-container web app | Dockerfile at project root |
What happens when deploy fails
PocketBay does not promise every project builds on the first try. The platform returns structured error categories, log tails, and repair hints; AI can fix source and redeploy after informing you. Common issues: runtime version too high, missing start command, dependency install failure, wrong port, and build timeout.
The full machine execution steps always follow the Agent Markdown manual.