From 224fc003c667f492bead98f9d3bc73230a48885f Mon Sep 17 00:00:00 2001 From: Kevin Longe <273747162+kvlonge@users.noreply.github.com> Date: Sat, 26 Sep 2026 04:09:56 +0100 Subject: [PATCH 1/5] docs: add a roadmap and mark beta warehouses --- website/public/index.html | 8 +++--- website/public/styles.css | 9 ++++++ .../content/docs/docs/concepts/adapters.mdx | 23 ++++++++------- .../docs/docs/concepts/adapters/bigquery.mdx | 6 ++++ .../docs/concepts/adapters/databricks.mdx | 6 ++++ .../docs/docs/concepts/adapters/sqlserver.mdx | 6 ++++ website/src/content/docs/docs/roadmap.mdx | 28 +++++++++++++++++++ website/src/navigation.mjs | 5 ++-- 8 files changed, 75 insertions(+), 16 deletions(-) create mode 100644 website/src/content/docs/docs/roadmap.mdx diff --git a/website/public/index.html b/website/public/index.html index 19e30fee54..d4b3f27551 100644 --- a/website/public/index.html +++ b/website/public/index.html @@ -408,13 +408,13 @@

Start simple

  • Free and open source, with no paid tier.
    • + Snowflake DuckDB MotherDuck - Snowflake - BigQuery - Databricks PostgreSQL - SQL Server + BigQuery Beta + Databricks Beta + SQL Server Beta 
    pip install sqlbuild
diff --git a/website/public/styles.css b/website/public/styles.css
index bf9b218e28..cda5822f58 100644
--- a/website/public/styles.css
+++ b/website/public/styles.css
@@ -597,6 +597,15 @@ h3 {
 	font-size: 13px;
 }
 
+.adapters small {
+	margin-left: 4px;
+	color: var(--muted-foreground);
+	font-size: 11px;
+	font-weight: 600;
+	letter-spacing: 0.04em;
+	text-transform: uppercase;
+}
+
 /* Closing call to action */
 .closing {
 	padding: 88px 0 96px;
diff --git a/website/src/content/docs/docs/concepts/adapters.mdx b/website/src/content/docs/docs/concepts/adapters.mdx
index fd0e6a7b1b..82a506cbae 100644
--- a/website/src/content/docs/docs/concepts/adapters.mdx
+++ b/website/src/content/docs/docs/concepts/adapters.mdx
@@ -3,22 +3,25 @@ title: "Overview"
 description: "Supported database engines and their connection configuration."
 ---
 
-SQLBuild uses adapters to connect to different database engines.
+SQLBuild uses adapters to connect to different database engines. Snowflake is the main target.
+
+- **Supported:** ready for production use.
+- **Beta:** builds, tests and plans work, but with less production use so far. Expect rough edges, and please [report issues](https://github.com/chio-labs/sqlbuild/issues).
 
 | Adapter | Status | Install |
 |---------|--------|---------|
+| [Snowflake](/docs/concepts/adapters/snowflake) | Supported | `sqlbuild[snowflake]` |
 | [DuckDB](/docs/concepts/adapters/duckdb) | Supported | included by default |
 | [MotherDuck](/docs/concepts/adapters/motherduck) | Supported | included by default (uses DuckDB) |
-| [Snowflake](/docs/concepts/adapters/snowflake) | Supported | `sqlbuild[snowflake]` |
-| [BigQuery](/docs/concepts/adapters/bigquery) | Supported | `sqlbuild[bigquery]` |
-| [Databricks](/docs/concepts/adapters/databricks) | Supported | `sqlbuild[databricks]` |
 | [PostgreSQL](/docs/concepts/adapters/postgres) | Supported | `sqlbuild[postgres]` |
-| [SQL Server](/docs/concepts/adapters/sqlserver) | Supported | `sqlbuild[sqlserver]` |
-| ClickHouse | Coming soon | |
-| Redshift | Coming soon | |
-| Trino | Coming soon | |
-| Spark | Coming soon | |
-| Athena | Coming soon | |
+| [BigQuery](/docs/concepts/adapters/bigquery) | Beta | `sqlbuild[bigquery]` |
+| [Databricks](/docs/concepts/adapters/databricks) | Beta | `sqlbuild[databricks]` |
+| [SQL Server](/docs/concepts/adapters/sqlserver) | Beta | `sqlbuild[sqlserver]` |
+| ClickHouse | Planned | |
+| Redshift | Planned | |
+| Trino | Planned | |
+| Spark | Planned | |
+| Athena | Planned | |
 
 Set the adapter in `sqlbuild_project.toml`:
 
diff --git a/website/src/content/docs/docs/concepts/adapters/bigquery.mdx b/website/src/content/docs/docs/concepts/adapters/bigquery.mdx
index 8804c3c5e7..3c9ec55a5d 100644
--- a/website/src/content/docs/docs/concepts/adapters/bigquery.mdx
+++ b/website/src/content/docs/docs/concepts/adapters/bigquery.mdx
@@ -3,6 +3,12 @@ title: "BigQuery"
 description: "BigQuery adapter configuration for SQLBuild."
 ---
 
+import Note from '../../../../../components/mintlify/Note.astro';
+
+
+The BigQuery adapter is in beta: builds, tests and plans work, but it has had less production use so far. Please [report issues](https://github.com/chio-labs/sqlbuild/issues).
+
+
 BigQuery requires the optional `google-cloud-bigquery` dependency:
 
 ```bash
diff --git a/website/src/content/docs/docs/concepts/adapters/databricks.mdx b/website/src/content/docs/docs/concepts/adapters/databricks.mdx
index dcf8504fef..a1ef6f4f4a 100644
--- a/website/src/content/docs/docs/concepts/adapters/databricks.mdx
+++ b/website/src/content/docs/docs/concepts/adapters/databricks.mdx
@@ -3,6 +3,12 @@ title: "Databricks"
 description: "Databricks adapter configuration for SQLBuild."
 ---
 
+import Note from '../../../../../components/mintlify/Note.astro';
+
+
+The Databricks adapter is in beta: builds, tests and plans work, but it has had less production use so far. Please [report issues](https://github.com/chio-labs/sqlbuild/issues).
+
+
 Databricks requires the optional `databricks-sql-connector` dependency:
 
 ```bash
diff --git a/website/src/content/docs/docs/concepts/adapters/sqlserver.mdx b/website/src/content/docs/docs/concepts/adapters/sqlserver.mdx
index 0d746ed3fe..13f0132d91 100644
--- a/website/src/content/docs/docs/concepts/adapters/sqlserver.mdx
+++ b/website/src/content/docs/docs/concepts/adapters/sqlserver.mdx
@@ -3,6 +3,12 @@ title: "SQL Server"
 description: "Microsoft SQL Server adapter configuration for SQLBuild."
 ---
 
+import Note from '../../../../../components/mintlify/Note.astro';
+
+
+The SQL Server adapter is in beta: builds, tests and plans work, but it has had less production use so far. Please [report issues](https://github.com/chio-labs/sqlbuild/issues).
+
+
 SQL Server requires the optional `pymssql` dependency:
 
 ```bash
diff --git a/website/src/content/docs/docs/roadmap.mdx b/website/src/content/docs/docs/roadmap.mdx
new file mode 100644
index 0000000000..ef7ffd11e0
--- /dev/null
+++ b/website/src/content/docs/docs/roadmap.mdx
@@ -0,0 +1,28 @@
+---
+title: "Roadmap"
+description: "What's coming next in SQLBuild."
+---
+
+SQLBuild is free and open source, and will stay that way. There is no paid tier, no commercial edition
+and no feature held back for one. Everything below ships in the open-source project and works on its own.
+
+## Next: the SQLBuild UI
+
+A self-hosted web app for your SQLBuild project:
+
+- Browse models, lineage and column types.
+- Follow runs, tests and audits as they happen.
+- Run builds and set them on a schedule.
+- See what your builds cost.
+- Sign in with SSO, with fine-grained permissions and audit logs.
+
+## Later
+
+- Moving BigQuery, Databricks and SQL Server from beta to supported.
+- Roles and grants managed as code.
+- More warehouses, such as ClickHouse, Redshift and Trino.
+
+## Not planned
+
+- **Virtual environments.** SQLBuild builds branches into their own schemas instead. That's simpler to
+  run, with no extra state to manage.
diff --git a/website/src/navigation.mjs b/website/src/navigation.mjs
index b0e003cb0e..fd8f105fb0 100644
--- a/website/src/navigation.mjs
+++ b/website/src/navigation.mjs
@@ -6,6 +6,7 @@ export const sidebar = [
 			"docs",
 			"docs/quickstart",
 			"docs/feature-comparison",
+			"docs/roadmap",
 			"docs/benchmarks"
 		]
 	},
@@ -27,12 +28,12 @@ export const sidebar = [
 				"collapsed": true,
 				"items": [
 					"docs/concepts/adapters",
+					"docs/concepts/adapters/snowflake",
 					"docs/concepts/adapters/duckdb",
 					"docs/concepts/adapters/motherduck",
-					"docs/concepts/adapters/snowflake",
+					"docs/concepts/adapters/postgres",
 					"docs/concepts/adapters/bigquery",
 					"docs/concepts/adapters/databricks",
-					"docs/concepts/adapters/postgres",
 					"docs/concepts/adapters/sqlserver"
 				]
 			},

From 9690299a1a473db75eb135577301c04db1549534 Mon Sep 17 00:00:00 2001
From: Kevin Longe <273747162+kvlonge@users.noreply.github.com>
Date: Sat, 26 Sep 2026 04:12:18 +0100
Subject: [PATCH 2/5] docs: keep roles and grants off the roadmap

---
 website/src/content/docs/docs/roadmap.mdx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/website/src/content/docs/docs/roadmap.mdx b/website/src/content/docs/docs/roadmap.mdx
index ef7ffd11e0..9effa6dbce 100644
--- a/website/src/content/docs/docs/roadmap.mdx
+++ b/website/src/content/docs/docs/roadmap.mdx
@@ -19,7 +19,6 @@ A self-hosted web app for your SQLBuild project:
 ## Later
 
 - Moving BigQuery, Databricks and SQL Server from beta to supported.
-- Roles and grants managed as code.
 - More warehouses, such as ClickHouse, Redshift and Trino.
 
 ## Not planned

From 6efb4d5cf281baa2f5cdb4043ba0f7e0d41ed4ac Mon Sep 17 00:00:00 2001
From: Kevin Longe <273747162+kvlonge@users.noreply.github.com>
Date: Sat, 26 Sep 2026 04:13:17 +0100
Subject: [PATCH 3/5] docs: give the real reason virtual environments are not
 planned

---
 website/src/content/docs/docs/roadmap.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/src/content/docs/docs/roadmap.mdx b/website/src/content/docs/docs/roadmap.mdx
index 9effa6dbce..e782e165ae 100644
--- a/website/src/content/docs/docs/roadmap.mdx
+++ b/website/src/content/docs/docs/roadmap.mdx
@@ -23,5 +23,5 @@ A self-hosted web app for your SQLBuild project:
 
 ## Not planned
 
-- **Virtual environments.** SQLBuild builds branches into their own schemas instead. That's simpler to
-  run, with no extra state to manage.
+- **Virtual environments.** They added a lot of complexity, and most of what they offered can be done
+  more simply in other ways.

From 96ef0fcd3926920726054a3c0237a6264b948e5f Mon Sep 17 00:00:00 2001
From: Kevin Longe <273747162+kvlonge@users.noreply.github.com>
Date: Sat, 26 Sep 2026 04:14:00 +0100
Subject: [PATCH 4/5] docs: use the present tense for the virtual environments
 reason

---
 website/src/content/docs/docs/roadmap.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/src/content/docs/docs/roadmap.mdx b/website/src/content/docs/docs/roadmap.mdx
index e782e165ae..c1da8e6cfe 100644
--- a/website/src/content/docs/docs/roadmap.mdx
+++ b/website/src/content/docs/docs/roadmap.mdx
@@ -23,5 +23,5 @@ A self-hosted web app for your SQLBuild project:
 
 ## Not planned
 
-- **Virtual environments.** They added a lot of complexity, and most of what they offered can be done
-  more simply in other ways.
+- **Virtual environments.** They add a lot of complexity, and most of what they offer can be done more
+  simply in other ways.

From f12b88082326c70dc98a204cf1dcea8749a1b7bc Mon Sep 17 00:00:00 2001
From: Kevin Longe <273747162+kvlonge@users.noreply.github.com>
Date: Sat, 26 Sep 2026 04:14:30 +0100
Subject: [PATCH 5/5] docs: note that the alternatives need no external state
 store

---
 website/src/content/docs/docs/roadmap.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/content/docs/docs/roadmap.mdx b/website/src/content/docs/docs/roadmap.mdx
index c1da8e6cfe..691c69a353 100644
--- a/website/src/content/docs/docs/roadmap.mdx
+++ b/website/src/content/docs/docs/roadmap.mdx
@@ -24,4 +24,4 @@ A self-hosted web app for your SQLBuild project:
 ## Not planned
 
 - **Virtual environments.** They add a lot of complexity, and most of what they offer can be done more
-  simply in other ways.
+  simply in other ways, without the need for an external state store.