DbState
Menu

DbState Documentation

Work with database state through explicit Git-managed workflows.

Learn how to set up a DbState workspace, capture PostgreSQL state into repository files, compare desired state with a target database, review differences, and prepare controlled release handoffs.

Getting StartedReview the Safety Model

Documentation map

Start with setup, then follow the workflow boundaries.

Start here

Getting StartedUnderstand what DbState is, what the Private Beta includes, and how to approach a first local PostgreSQL evaluation.Workspace SetupSet up a local Git repository that DbState can use as the desired-state workspace for database objects, reference data, and review artifacts.

Schema workflows

Schema CompareCompare PostgreSQL database objects in both directions while keeping database mutation and Git operations outside automatic DbState behavior.Object and Data DiffUnderstand how DbState separates object-level review from row-level reference-data review.

Reference data

Reference DataManage selected PostgreSQL reference-data tables as repository YAML and compare row state without automatic data mutation.

Release preparation

Release PlansBuild review-only handoffs for supported schema candidates without turning DbState into a database execution tool.

Trust and scope

Safety ModelReview the boundaries that keep inspection, repository writes, comparison, release preparation, Git history, and database execution separate.Known LimitationsReview the current Private Beta platform, workflow, database, and safety boundaries before evaluating DbState.