diff --git a/docs/_assets/icon/crystal-logo.svg b/docs/_assets/icon/crystal-logo.svg
new file mode 100644
index 00000000..5262fd6e
--- /dev/null
+++ b/docs/_assets/icon/crystal-logo.svg
@@ -0,0 +1,4 @@
+<svg height="207.90187" viewBox="0 0 207.90188 207.90188" width="207.90187" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="103.95094" cy="103.95094" fill="#fff" fill-opacity=".965067" r="103.66196" stroke="#fffffe" stroke-linecap="round" stroke-width=".377953"/>
+  <path d="m172.40984 122.47634-50 49.9c-.2.2-.5.3-.7.2l-68.300004-18.3c-.3-.1-.5-.3-.5-.5l-18.4-68.200003c-.1-.3 0-.5.2-.7l50-49.899999c.2-.2.5-.3.7-.2l68.300004 18.299999c.3.1.5.3.5.5l18.3 68.200003c.2.3.1.5-.1.7zm-67-54.300003-67.100004 17.9c-.1 0-.2.2-.1.3l49.1 49.000003c.1.1.3.1.3-.1l18.000004-67.000003c.1 0-.1-.2-.2-.1z"/>
+</svg>
diff --git a/docs/connect/crystal/index.md b/docs/connect/crystal/index.md
new file mode 100644
index 00000000..b7602e6a
--- /dev/null
+++ b/docs/connect/crystal/index.md
@@ -0,0 +1,66 @@
+(connect-crystal)=
+
+# Crystal
+
+:::{div} sd-text-muted
+Connect to CrateDB from Crystal applications.
+:::
+
+:::{rubric} About
+:::
+
+[crystal-pg] is a native, non-blocking Postgres driver for Crystal,
+building upon [crystal-db].
+
+:::{rubric} Synopsis
+:::
+
+`shard.yml`
+```yaml
+name: cratedb_demo
+version: 0.0.0
+dependencies:
+  pg:
+    github: will/crystal-pg
+```
+`example.cr`
+```crystal
+require "db"
+require "pg"
+
+DB.open("postgres://crate:crate@localhost:5432/?sslmode=disable") do |db|
+
+  db.query "SELECT mountain, height FROM sys.summits ORDER BY height DESC LIMIT 3" do |rs|
+    puts "#{rs.column_name(0)} #{rs.column_name(1)}"
+    rs.each do
+      puts "#{rs.read(String)}: #{rs.read(Int32)}"
+    end
+  end
+
+end
+```
+
+:::{include} ../_cratedb.md
+:::
+```shell
+shards install
+```
+```shell
+crystal example.cr
+```
+
+:::{rubric} SSL connection
+:::
+
+Use the `sslmode=require&auth_methods=cleartext` parameters,
+and replace username, password,
+and hostname with values matching your environment.
+Also use this variant to connect to CrateDB Cloud.
+
+```crystal
+DB.open("postgres://admin:password@testcluster.cratedb.net:5432/?sslmode=require&auth_methods=cleartext")
+```
+
+
+[crystal-db]: https://github.com/crystal-lang/crystal-db
+[crystal-pg]: https://github.com/will/crystal-pg
diff --git a/docs/connect/index.md b/docs/connect/index.md
index 84404e82..d9529b11 100644
--- a/docs/connect/index.md
+++ b/docs/connect/index.md
@@ -75,6 +75,19 @@ Any (ODBC)
 C#
 ::::
 
+::::{grid-item-card}
+:link: connect-crystal
+:link-type: ref
+:link-alt: Connect to CrateDB using Crystal
+:class-body: sd-fs-1 sd-text-center
+:class-footer: sd-fs-5 sd-font-weight-bold
+```{image} /_assets/icon/crystal-logo.svg
+:height: 70px
+```
++++
+Crystal
+::::
+
 ::::{grid-item-card}
 :link: connect-elixir
 :link-type: ref
@@ -336,6 +349,7 @@ application
 :maxdepth: 1
 :hidden:
 
+crystal/index
 csharp/index
 elixir/index
 erlang/index