Examples
Real-world flow files from the flow-examples repository, organized by category. Each file is a self-contained reference showing a different aspect of flow — browse by category or expand any card to view the full source.
To run these examples locally:
# Register the examples repo as a workspace
flow workspace add examples https://github.com/flowexec/examples.git --set
# Browse all executables interactively
flow browsegithub
Interact with the GitHub REST API using flow's request executable. All endpoints used here are public and require no authentication. Add a secretRef for GITHUB_TOKEN when hitting authenticated endpoints.
exec
Exec executables run shell commands or script files. This file demonstrates the core options available on exec executables.
scripts
Flow can automatically generate executables from annotated shell scripts using the `fromFile` field. Add `# f:` comment directives to any existing script and flow imports it at sync time — no rewriting required. This is a powerful migration path: teams can wrap existing Bash scripts, deploy pipelines, or CI helpers in flow immediately and refine them over time. See `assets/scripts/annotated-deploy.sh` for the comment syntax.
launch
Launch executables open URIs or applications without shell scripting. This file demonstrates the core options available on launch executables.
parallel
Parallel executables run multiple tasks concurrently. This file demonstrates the core options available on parallel executables.
render
Render executables display Markdown templates in flow's TUI. Templates support Go template syntax and can pull in data from YAML files and params.
request
Request executables send HTTP requests without leaving flow. This file demonstrates the core options available on request executables.
serial
Serial executables run a list of steps in order. Steps can reference other executables, run inline commands, or both. This file demonstrates the core options available on serial executables.
docker
Container workflow automation using Docker. Covers building images with configurable tags, running containers locally, pushing to a registry, and cleaning up unused resources.
git
Common git workflow helpers for day-to-day development. Covers committing and pushing, syncing with the base branch, cleaning up merged branches, and getting a quick status overview.
go
Build automation for a Go project. Covers compiling binaries, code generation, and dependency management. Adapt paths and commands to your own project.
go
Linting and static analysis for a Go project. Runs all checks concurrently for fast feedback. Requires golangci-lint and govulncheck to be installed.
go
Release pipeline for a Go project. The main `release` executable runs the full lint → test → build → tag pipeline. Also includes a local snapshot build for testing the release config without publishing.
go
Test automation for a Go project. Runs unit and integration tests in parallel, and generates HTML coverage reports. Adapt tags and paths to your own project.
k8s
Day-to-day Kubernetes cluster operations via kubectl. Covers context switching, applying manifests, inspecting pods, streaming logs, and opening an interactive shell inside a running container.
k8s
Helm shared-library pattern. Generic `install helm-chart` and `verify deployment` utilities are called by app-specific deployers with different positional args — add a new app by copying the pattern, not the logic.
db
Database lifecycle management for a local SQLite database. All executables target the same `db` resource name with different verbs — showing how flow organizes the full lifecycle of a single resource: migrate, check, inspect, backup, rollback, and clean.