Postgres is the walkthrough source; other catalogue examples depend on connector capability metadata.
Git-native data pipelines, run from the CLI.
Braidplane is a developer-first, ETL-first operating layer for data teams that want Git-native pipeline authoring and CLI-first operation. The CLI controls the workflow; Braidplane runs it and keeps every run, schedule, source checkpoint, contract, and validation result in a readable operational trail.
High-level ETL walkthrough: source, transform, sink.
The first walkthrough keeps the shape generic: connected systems read, native SQL transforms, and target systems receive validated output.
Native SQL handles the transform step today, with more transform options coming.
S3 is the walkthrough sink; write targets depend on connector capability metadata.
Source capability
Postgres is the walkthrough source; connector metadata decides which systems can read.
See how the pipeline is defined.
Two source reads, one sql_v1 join transform, one JSON write, with optional contracts around the transform.
- SourceOrders and customers come from logical source references.
- TransformNative SQL maps the two row sets into joined order records.
- SinkEach run writes a scoped JSON object to the target system.
Open the pipeline spec
metadata: slug: golden-path-joined-orders name: Golden Path Joined Orderssteps: - kind: query slug: fetch-paid-orders name: Fetch paid orders query: data_source_ref: golden-path-orders-postgres operation_type: sql operation_ref: golden-path-orders output_contract: name: golden-path-paid-orders representation: rows fields: - name: order_id type: string required: true - name: customer_slug type: string required: true - name: order_total_cents type: integer required: true - name: discount_cents type: integer required: true - name: net_total_cents type: integer required: true - name: placed_at_utc type: string required: true - kind: query slug: fetch-active-customers name: Fetch active customers query: data_source_ref: golden-path-customers-postgres operation_type: sql operation_ref: golden-path-customers output_contract: name: golden-path-active-customers representation: rows fields: - name: customer_slug type: string required: true - name: customer_name type: string required: true - name: customer_segment type: string required: true - name: region type: string required: true - kind: transform slug: join-orders-customers name: Join orders to active customers transform: inputs: orders: fetch-paid-orders customers: fetch-active-customers input_contract: name: golden-path-join-inputs representation: rows fields: - name: orders.order_id type: string required: true - name: orders.customer_slug type: string required: true - name: orders.order_total_cents type: integer required: true - name: orders.discount_cents type: integer required: true - name: orders.net_total_cents type: integer required: true - name: orders.placed_at_utc type: string required: true - name: customers.customer_slug type: string required: true - name: customers.customer_name type: string required: true - name: customers.customer_segment type: string required: true - name: customers.region type: string required: true sql: | SELECT orders.order_id AS order_id, orders.customer_slug AS customer_slug, customers.customer_name AS customer_name, customers.customer_segment AS customer_segment, customers.region AS region, orders.order_total_cents AS order_total_cents, orders.discount_cents AS discount_cents, orders.net_total_cents AS net_total_cents, CAST(orders.net_total_cents AS DOUBLE) / 100 AS net_total_amount, orders.placed_at_utc AS placed_at_utc FROM orders JOIN customers ON customers.customer_slug = orders.customer_slug ORDER BY placed_at_utc, order_id output_kind: rows output_contract: name: golden-path-joined-orders representation: rows fields: - name: order_id type: string required: true - name: customer_slug type: string required: true - name: customer_name type: string required: true - name: customer_segment type: string required: true - name: region type: string required: true - name: order_total_cents type: integer required: true - name: discount_cents type: integer required: true - name: net_total_cents type: integer required: true - name: net_total_amount type: number required: true - name: placed_at_utc type: string required: true - kind: sink slug: write-joined-orders name: Write joined orders to S3 sink: idempotency_class: naturally_idempotent input: join-orders-customers input_contract: name: golden-path-joined-orders-s3-input representation: rows fields: - name: order_id type: string required: true - name: customer_slug type: string required: true - name: customer_name type: string required: true - name: customer_segment type: string required: true - name: region type: string required: true - name: order_total_cents type: integer required: true - name: discount_cents type: integer required: true - name: net_total_cents type: integer required: true - name: net_total_amount type: number required: true - name: placed_at_utc type: string required: true data_source_ref: golden-path-s3-sink operation_type: s3 operation_ref: golden-path-s3-write-joined-orders config: key: runs/{{runtime.sink_replay_identity}}/joined-orders.json format: json content_type: application/json metadata: source: braidplane-golden-path run: "{{runtime.run_slug}}" overwrite: trueA Git-first operating layer for ETL data pipelines.
Braidplane gives teams a standard runtime for repeatable ETL workflows: connectors, contracts, transforms, deployments, runs, retries, diagnostics, and auditability. Custom code still has a place; routine data movement should not default to a bespoke runtime to package, patch, deploy, and debug.
Spec-first declarative ETL
Define sources, native SQL transforms, sinks, contracts, schedules, and runs in pipeline specs. YAML and JSON work today, CUE support is pending, and routine ETL runs through reviewed specs and a managed runtime boundary.
Connected business systems
Register databases, warehouses, APIs, SaaS systems, files, Git, S3, and even HTTP operations with credential safety and readiness checks.
Environment-aware deploys
Promote the same pipeline version across dev, staging, and prod while each environment resolves its own bindings.
Operable run history
Inspect what ran, why it ran, what moved, what failed, and whether a run can be replayed or retried.
Current pre-alpha surface What Braidplane already includes CLI operation, machine access, incrementals, events, alerts, notifications, contracts, and deployment evidence are already part of the current surface.
For technical evaluators who want the fuller scope, this is the current pre-alpha surface behind the walkthrough.
Talk to us about your operational data workflow.
Interested in early access? Email us. We will use the information you provide only to answer your request. Contacting us does not create an account, subscribe you to marketing, or guarantee access.
No public launch date yet. Pre-alpha access remains guided.