Dockerfile that serves on 0.0.0.0:$PORT. Dockerfiles has one to copy for Next.js, Rails, Django, FastAPI, and Express. The examples use Next.js on port 3000.
Set up your agent
floo skills install --path .claude/skills/floo. Cursor, Codex, and other agents: Agent setup.
Agent prompt
Paste into your agent. Replacestorefront with your app name.
floo.app.toml
floo.app.toml
[app] access_mode = "public" opens prod to anyone. The two [environments.<env>] overrides keep dev and previews invite-only. Dev and prod each get their own Postgres with separate credentials, injected as DATABASE_URL. The first prod release creates the domain.
Deploy to dev, then release to prod
https://storefront.getfloo.app, signed in. When a version is ready for customers, replace owner/repo with your GitHub repository and release it:
https://storefront-prod.getfloo.app. A push never changes prod. For an app floo hosts, run floo promote --app storefront instead.
Point your domain at prod
The first prod release prints the DNS records forshop.example.com. Read them again at any time:
Verify
curl returns your page with no redirect to sign-in. Opening the dev URL in a private window shows floo’s sign-in page.
Next steps
Custom domains
DNS records, activation, apex domains, and per-service domains.
Production environments
Releases, per-environment env vars, and the two URLs.
Releases and rollbacks
Put the previous version back when a release goes wrong.
Preview environments
Review each pull request on its own URL and database branch.