diff --git a/README.md b/README.md
index 8735d36f255..20232cdc35b 100644
--- a/README.md
+++ b/README.md
@@ -61,19 +61,116 @@ You can also [self-host](https://supabase.io/docs/guides/self-hosting) and [deve
#### Client libraries
-Our client library is modular. Each sub-library is a standalone implementation for a single external system. This is one of the ways we support existing tools.
+Our approach for client libraries is modular. Each sub-library is a standalone implementation for a single external system. This is one of the ways we support existing tools.
-- **`supabase-{lang}`**: Combines libraries and adds enrichments.
- - `postgrest-{lang}`: Client library to work with [PostgREST](https://github.com/postgrest/postgrest)
- - `realtime-{lang}`: Client library to work with [Realtime](https://github.com/supabase/realtime)
- - `gotrue-{lang}`: Client library to work with [GoTrue](https://github.com/netlify/gotrue)
-
-| Repo | Official | Community |
-| --------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **`supabase-{lang}`** | [`JS`](https://github.com/supabase/supabase-js) | [`C#`](https://github.com/supabase/supabase-csharp) \| [`Dart`](https://github.com/supabase/supabase-dart) \| [`Python`](https://github.com/supabase/supabase-py) \| `Rust` \| [`Ruby`](https://github.com/supabase/supabase-rb) \| `Go` |
-| `postgrest-{lang}` | [`JS`](https://github.com/supabase/postgrest-js) | [`C#`](https://github.com/supabase/postgrest-csharp) \| [`Dart`](https://github.com/supabase/postgrest-dart) \| [`Python`](https://github.com/supabase/postgrest-py) \| [`Rust`](https://github.com/supabase/postgrest-rs) \| [`Ruby`](https://github.com/supabase/postgrest-rb) \| [`Go`](https://github.com/supabase/postgrest-go) |
-| `realtime-{lang}` | [`JS`](https://github.com/supabase/realtime-js) | [`C#`](https://github.com/supabase/realtime-csharp) \| [`Dart`](https://github.com/supabase/realtime-dart) \| [`Python`](https://github.com/supabase/realtime-py) \| `Rust` \| `Ruby` \| `Go` |
-| `gotrue-{lang}` | [`JS`](https://github.com/supabase/gotrue-js) | [`C#`](https://github.com/supabase/gotrue-csharp) \| [`Dart`](https://github.com/supabase/gotrue-dart) \| [`Python`](https://github.com/supabase/gotrue-py) \| `Rust` \| `Ruby` \| `Go` |
+
diff --git a/web/spec/supabase.yml b/web/spec/supabase.yml
index 4f989fa9315..a7e7cec2a5d 100644
--- a/web/spec/supabase.yml
+++ b/web/spec/supabase.yml
@@ -4,16 +4,105 @@ info:
id: reference/supabase-js
title: Supabase Client
description: |
+ Our approach for client libraries is modular. Each sub-library is a standalone implementation for a single external system. This is one of the ways we support existing tools.
- Our client library is modular. Each sub-library is a standalone implementation for a single external system. This is one of the ways we support existing tools.
-
-
- | Repo | Official | Community |
- |-----------------------|--------------------------------------------------|------------------|
- | **`supabase-{lang}`**
Combines libraries and adds enrichments. | [`JavaScript`](https://github.com/supabase/supabase-js) | [`C#`](https://github.com/supabase/supabase-csharp), [`Python`](https://github.com/supabase/supabase-py), `Rust`, [`Dart`](https://github.com/supabase/supabase-dart) |
- | `postgrest-{lang}`
Client library to work with [PostgREST](https://github.com/postgrest/postgrest) | [`JavaScript`](https://github.com/supabase/postgrest-js) | [`C#`](https://github.com/supabase/postgrest-csharp), [`Python`](https://github.com/supabase/postgrest-py), [`Rust`](https://github.com/supabase/postgrest-rs), [`Kotlin`](https://github.com/supabase/postgrest-kt), [`Dart`](https://github.com/supabase/postgrest-dart) |
- | `realtime-{lang}`
Client library to work with [Realtime](https://github.com/supabase/realtime) | [`JavaScript`](https://github.com/supabase/realtime-js) | [`C#`](https://github.com/supabase/realtime-csharp), [`Python`](https://github.com/supabase-community/realtime-py), `Rust`, [`Dart`](https://github.com/supabase/realtime-dart) |
- | `gotrue-{lang}`
Client library to work with [GoTrue](https://github.com/netlify/gotrue) | [`JavaScript`](https://github.com/supabase/gotrue-js) | [`C#`](https://github.com/supabase/gotrue-csharp), [`Python`](https://github.com/supabase-community/gotrue-py), `Rust`, [`Kotlin`](https://github.com/supabase/gotrue-kt), [`Dart`](https://github.com/supabase/gotrue-dart) |
+
definition: spec/combined.json
libraries: