A collection of real-world flow automation examples showing how developers use flow to automate their daily workflows. Intended as a living reference and starting point for your own workspace.

Getting Started

# Register this repo as a flow workspace
flow workspace add flow-examples . --set

# Browse all available executables
flow browse

Structure

Directory	What it shows
basics/	Core feature reference — one file per executable type
go-project/	Full developer lifecycle (build, test, lint, release) — same pattern applies to any ecosystem (Node, Rust, Python…)
git/	Git workflow helpers (commit, fetch/rebase, branch cleanup)
api/	HTTP automation — GitHub REST API, webhook dispatch
docker/	Driving the docker CLI as the task — build, run, push, clean
container/	Running executables inside an image with exec's container block — pinned toolchains, volumes, entrypoints
python/	Python executables — inline interpreter: python, .py files, params via os.environ, mixed shell/Python steps
kubernetes/	kubectl automation (context, apply, pods, logs, shell) + Helm shared-library pattern (reusable installer called by app deployers)
setup/	Project onboarding (prereq checks, tool install, env config)
assets/	Supporting scripts and templates referenced by examples

Template

exec-template.flow.tmpl is an executable template — run it to scaffold a starter flow file for a new project:

flow template generate NAME exec-template.flow.tmpl

Validation

Every .flow file, the workspace config, and the template are schema-validated in CI against flow's main build:

flow validate

Examples using recently-added fields are validated against main rather than the latest release, so a feature can be demonstrated here as soon as it lands.