Pubflow CLI

Create, inspect, and upgrade Pubflow apps from your terminal.

The Pubflow CLI is the friendly command center for starter kits, AI context, env vars, clients, middleware, project checks, docs, and next-step hints.

package: pubflowbinaries: pubflow + pbflNode >=18.17
pubflow terminalNode >=18.17
$ pubflow init
$ pbfl init
$ pubflow add middleware
$ pubflow inspect
Use `pubflow` or the shorter `pbfl` binary. Start a new app or safely add Pubflow to the project you already have.

One CLI, two paths

Start fresh or upgrade what already exists.

The CLI detects your stack, recommends the right path, and keeps the next step obvious.

Create a project in the stack you want.

`pubflow init` opens the guided flow. `pubflow create` can launch React, Next.js, React Native, Node, Python, Go, Rust, or Elixir starters directly.

pubflow init
pubflow create next my-next-web
pubflow create python-backend my-api --no-install --no-git

What it handles

All the setup work around Pubflow, one command at a time.

Starter projects

Create frontend and backend starters for React, Next.js, React Native, Node, Python, Go, Rust, and Elixir.

Env contracts

Add public-safe frontend vars or backend Bridge Validation vars to `.env.example`, with `.env` only when confirmed.

Clients

Install the recommended Flowfull client for React, React Native, universal JS, Python, Go, Rust, or Elixir.

Middleware

Generate Bridge Validation middleware for Node, FastAPI, Gin, Axum, and Phoenix patterns.

AI context

Install `.pubflow/context` plus agent references for AGENTS.md, Cursor, Copilot, and Claude.

Doctor

Check local tools like Node, npm, Bun, git, Python, Go, Cargo, rustc, and Elixir Mix.

Hints

Show friendly next steps for clients, middleware, env, context, and general setup.

Docs launcher

Jump to Pubflow, Bridge Validation, starters, Flowfull, Flowless, clients, and context docs.

Built safe

Helpful automation without mystery changes.

The CLI is designed to add files and guidance intentionally, so teams can understand every change before it matters.

No real secrets

Generated env values use placeholders. Real secrets stay yours.

.env.example first

The default path documents required vars without silently changing local secrets.

No route overwrites

Middleware is created in new files; if `bridge` exists, it falls back to `pubflow` naming.

Marked agent blocks

Agent/editor references use marked sections so updates do not duplicate content.

Make setup feel boringly easy.

Start with `pubflow init`, add only what you need, and let the CLI keep your team pointed at the next safe step.