# floo

> floo is a CLI-first deployment platform. Deploy apps by pushing to GitHub. Manages Postgres, Redis, object storage, cron, custom domains, and auth. Every command supports `--json` for agent and script integration.

## Build with...

- [Build a Next.js app on floo](https://getfloo.com/docs/build/nextjs.md): End-to-end Next.js (App Router) journey — Dockerfile (standalone), NEXT_PUBLIC_* build args, deploy, add Postgres (Prisma), add per-user auth via gateway-managed accounts mode, add a custom domain.
- [Build a Rails app on floo](https://getfloo.com/docs/build/rails.md): End-to-end Rails journey — Dockerfile, deploy, local dev with prod-shaped env (`floo dev`), one-shot commands like rake tasks / db:seed / `bin/rails console` (`floo run`), add Postgres, add per-user auth via gateway-managed accounts mode (read identity headers in ApplicationController), add a custom domain.
- [Build a FastAPI app on floo](https://getfloo.com/docs/build/fastapi.md): End-to-end FastAPI journey — Dockerfile, deploy, add Postgres (async SQLAlchemy), add per-user auth via gateway-managed accounts mode (FastAPI dependency reads identity headers), add a custom domain.
- [Build a Django app on floo](https://getfloo.com/docs/build/django.md): End-to-end Django journey — Dockerfile (gunicorn + whitenoise), deploy, add Postgres (dj-database-url), add per-user auth via gateway-managed accounts mode (FlooUserMiddleware), add a custom domain.
- [Build an Express app on floo](https://getfloo.com/docs/build/express.md): End-to-end Express (Node.js) journey — Dockerfile, deploy, add Postgres (pg or Prisma), add per-user auth via gateway-managed accounts mode (read identity headers in middleware), add a custom domain.

## Guides

- [Introduction](https://getfloo.com/docs/introduction.md): Deploy your app from the terminal — install, auth, connect GitHub, and ship.
- [Golden Path](https://getfloo.com/docs/guides/golden-path.md): The exact commands to go from zero to deployed.
- [AI Agent Setup](https://getfloo.com/docs/guides/agent-setup.md): Give your coding agent the floo skill so it can deploy, manage, and debug your apps.
- [Configuration](https://getfloo.com/docs/guides/configuration.md): Understand what floo init creates and how to edit config files.
- [Dockerfiles](https://getfloo.com/docs/guides/dockerfiles.md): Dockerfile requirements and automatic Docker Hub caching.
- [Git Push Deploy](https://getfloo.com/docs/guides/git-push-deploy.md): Push to GitHub to deploy — the primary deploy flow.
- [Managed Services](https://getfloo.com/docs/guides/managed-services.md): Add managed Postgres, Redis, and Storage to your app.
- [Multi-Service Routing](https://getfloo.com/docs/guides/multi-service-routing.md): How floo routes traffic across services with path-prefix routing.
- [Rollbacks](https://getfloo.com/docs/guides/rollbacks.md): Promote named releases and roll back to prior deploys.
- [Environment Variables](https://getfloo.com/docs/guides/environment-variables.md): Set, inspect, import, and scope env vars.
- [Custom Domains](https://getfloo.com/docs/guides/custom-domains.md): Add a custom domain to your floo app with automatic SSL.
- [Logs](https://getfloo.com/docs/guides/logs.md): Use runtime logs, build logs, and deploy watch together.
- [Databases](https://getfloo.com/docs/guides/databases.md): Provision Postgres and Redis with `floo services add`.
- [Cloud Storage](https://getfloo.com/docs/guides/cloud-storage.md): Provision storage, read STORAGE_BUCKET and STORAGE_URL, upload with signed URLs.
- [Cron Jobs](https://getfloo.com/docs/guides/cron-jobs.md): Schedule recurring tasks inside your app's containers with [cron.<name>] in floo.app.toml.
- [Budget Controls](https://getfloo.com/docs/guides/budget-controls.md): Inspect plan usage and set a hard spend cap.
- [App Auth](https://getfloo.com/docs/guides/app-auth.md): Add per-user authentication by setting access_mode = "accounts" — gateway-managed sign-in, identity headers on every request, no app auth code.
- [Team Access](https://getfloo.com/docs/guides/team-access.md): Manage org members, app access modes, and password-protected apps.

## CLI Reference

- [CLI Overview](https://getfloo.com/docs/cli/overview.md): Output modes, app inference, dry runs, and command discovery.
- [auth](https://getfloo.com/docs/cli/auth.md): Authenticate with the floo API (login, logout, whoami, token, register, update-profile).
- [init](https://getfloo.com/docs/cli/init.md): Initialize a new floo project.
- [preflight](https://getfloo.com/docs/cli/preflight.md): Validate project config and check deploy readiness.
- [redeploy](https://getfloo.com/docs/cli/redeploy.md): Force a redeploy after env var changes or config updates.
- [deploys](https://getfloo.com/docs/cli/deploys.md): View and manage deploy history (list, logs, watch, rollback).
- [dev](https://getfloo.com/docs/cli/dev.md): Run all services locally with managed service credentials.
- [apps](https://getfloo.com/docs/cli/apps.md): Manage your deployed apps (list, status, delete, password, github).
- [github](https://getfloo.com/docs/cli/github.md): Manage GitHub integration for auto-deploy (connect, disconnect, status).
- [env](https://getfloo.com/docs/cli/env.md): Manage environment variables (set, get, list, remove, import).
- [services](https://getfloo.com/docs/cli/services.md): Provision, inspect, and remove managed services.
- [cron](https://getfloo.com/docs/cli/cron.md): List and manually trigger scheduled cron jobs (declared in floo.app.toml under [cron.<name>]; CLI is read-only + manual trigger).
- [domains](https://getfloo.com/docs/cli/domains.md): Manage custom domains (add, list, remove).
- [logs](https://getfloo.com/docs/cli/logs.md): View runtime logs with filters (tail, since, error, severity, services, search, live).
- [releases](https://getfloo.com/docs/cli/releases.md): Manage releases and promote apps to production (list, show, promote).
- [billing](https://getfloo.com/docs/cli/billing.md): Manage billing and spend caps (spend-cap get/set, upgrade, usage, contact).
- [orgs](https://getfloo.com/docs/cli/orgs.md): Manage organization members and roles (members list, members set-role).
- [analytics](https://getfloo.com/docs/cli/analytics.md): View traffic analytics for an app or org.
- [skills](https://getfloo.com/docs/cli/skills.md): Install the floo agent skill file.
- [database](https://getfloo.com/docs/cli/database.md): Read managed Postgres, Redis, and Storage env vars through floo env.
- [update](https://getfloo.com/docs/cli/update.md): Check the installed floo version and update the CLI.

## Config Reference

- [Config File Spec](https://getfloo.com/docs/reference/config-spec.md): All floo config fields, file shapes, and precedence rules.
- [Error Codes](https://getfloo.com/docs/reference/error-codes.md): All floo CLI error codes with descriptions and troubleshooting.
- [.flooignore](https://getfloo.com/docs/reference/flooignore.md): Control which files are included in builds.