Workflow Block Guide

A small public-facing guide for troubleshooting Roboflow Workflow blocks. Users pick a block, then see curated preceding and following blocks, required versus popular connections, block notes, and documentation links.

The app is intentionally static so it can be hosted cheaply on GitHub Pages, Netlify, Cloudflare Pages, or any simple file host. Workflow_Blocks_db.csv remains the editable seed data, data/workflow_blocks.sqlite is the normalized database artifact, and public/data/workflow_blocks.json is the browser-facing export.

Run Locally

PowerShell:

.\blocks_venv\Scripts\Activate.ps1
python scripts\import_csv.py
python -m http.server 8000 --directory public

BASH:

source blocks_venv/Scripts/activate
python scripts/import_csv.py
python -m http.server 8000 --directory public

Open http://localhost:8000.

Verify

PowerShell:

.\blocks_venv\Scripts\Activate.ps1
python scripts\import_csv.py
python scripts\lint.py
python -m compileall scripts tests
python -m unittest discover -s tests

BASH:

source blocks_venv/Scripts/activate
python scripts/import_csv.py
python scripts/lint.py
python -m compileall scripts tests
python -m unittest discover -s tests

Data Model

• blocks: unique workflow blocks with category, summary, and documentation URL.
• connections: curated directed relationships between blocks.
• relationship: required or commonly_used.
• Browser data is generated from the CSV; do not hand-edit public/data/workflow_blocks.json.

Only add new block notes after review. The goal is to keep this as a troubleshooting guide for common issues, not an exhaustive catalog.