Airflow Python React Widgets

A Python → React widgets framework for Apache Airflow 3.1 that lets you attach rich, contextual UI panels to Airflow pages (e.g., task instance views).
The core idea: write widgets in Python (per DAG / per task), serve them via a small FastAPI plugin endpoint, and render them in the Airflow UI using a React panel.

This project currently focuses on being:

• Simple to author: “just return a list of widget specs”

• Fast in the UI: widgets are computed at page-load time → keep them lightweight

• Extensible: add new widget types on the React side without changing Airflow internals

What it supports today

Widget types

• Markdown: runbooks, descriptions, links, snippets

• Tables: key/value blocks, metrics tables, column dictionaries

• Mermaid diagrams (via Markdown): lineage/flow diagrams rendered by your Markdown renderer (must support ```mermaid)

Where widgets can appear

• Task Instance views (recommended first target; easiest mental model)

• Can be extended to DAG, TaskGroup, Run pages depending on Airflow’s react_apps.destination support in your version.