docs(repo): change client libraries references to sdk

mandarini · mandarini · commit c36af994c2ff · 2025-10-15T14:50:14.000+03:00
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -100,33 +100,33 @@ jobs:
           </head>
           <body>
               <h1>Supabase JavaScript Libraries - API Documentation</h1>
-              <p>TypeScript/JavaScript API documentation for all Supabase client libraries.</p>
+              <p>TypeScript/JavaScript API documentation for all Supabase JS SDKs.</p>
               
               <h2>Available Documentation:</h2>
               <ul>
                   <li>
                       <a href="auth-js/v2/spec.json">@supabase/auth-js</a>
-                      <div class="description">Authentication client library</div>
+                      <div class="description">Authentication SDK</div>
                   </li>
                   <li>
                       <a href="functions-js/v2/spec.json">@supabase/functions-js</a>
-                      <div class="description">Edge Functions client library</div>
+                      <div class="description">Edge Functions SDK</div>
                   </li>
                   <li>
                       <a href="postgrest-js/v2/spec.json">@supabase/postgrest-js</a>
-                      <div class="description">PostgREST database client</div>
+                      <div class="description">PostgREST database SDK</div>
                   </li>
                   <li>
                       <a href="realtime-js/v2/spec.json">@supabase/realtime-js</a>
-                      <div class="description">Realtime subscriptions client</div>
+                      <div class="description">Realtime subscriptions SDK</div>
                   </li>
                   <li>
                       <a href="storage-js/v2/spec.json">@supabase/storage-js</a>
-                      <div class="description">File storage client</div>
+                      <div class="description">File storage SDK</div>
                   </li>
                   <li>
                       <a href="supabase-js/v2/spec.json">@supabase/supabase-js</a>
-                      <div class="description">Main isomorphic client combining all libraries</div>
+                      <div class="description">Main isomorphic SDK combining all SDKs</div>
                   </li>
               </ul>
               
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,6 +1,6 @@
 # Contributing to Supabase JS Libraries
 
-Thank you for your interest in contributing to the Supabase JavaScript client libraries! This guide will help you get started with contributing to the Supabase JS monorepo.
+Thank you for your interest in contributing to the Supabase JavaScript SDK! This guide will help you get started with contributing to the Supabase JS monorepo.
 
 > **Repository Structure Changed:** This repository has been restructured as a monorepo. **All libraries, including `supabase-js`, are now under `packages/core/`**. If you previously contributed to `supabase-js`, `auth-js`, `postgrest-js`, `realtime-js`, `storage-js`, or `functions-js`, please read our **[Migration Guide](docs/MIGRATION.md)** to understand:
 >
diff --git a/README.md b/README.md
@@ -8,7 +8,7 @@
     </picture>
   </a>
 
-  <h1 align="center">Supabase JS Client Libraries</h1>
+  <h1 align="center">Supabase JS SDK</h1>
 
   <p align="center">
     <a href="https://supabase.com/docs/guides/getting-started">Guides</a>
@@ -36,16 +36,16 @@
 
 ## 📦 Libraries
 
-This monorepo contains the complete suite of Supabase JavaScript client libraries:
+This monorepo contains the complete suite of Supabase JavaScript SDK:
 
 | Library                                                    | Description                              |
 | ---------------------------------------------------------- | ---------------------------------------- |
-| **[@supabase/supabase-js](./packages/core/supabase-js)**   | Main isomorphic client for Supabase      |
-| **[@supabase/auth-js](./packages/core/auth-js)**           | Authentication client                    |
-| **[@supabase/postgrest-js](./packages/core/postgrest-js)** | PostgREST client for database operations |
-| **[@supabase/realtime-js](./packages/core/realtime-js)**   | Real-time subscriptions client           |
-| **[@supabase/storage-js](./packages/core/storage-js)**     | File storage client                      |
-| **[@supabase/functions-js](./packages/core/functions-js)** | Edge Functions client                    |
+| **[@supabase/supabase-js](./packages/core/supabase-js)**   | Main isomorphic sdk for Supabase      |
+| **[@supabase/auth-js](./packages/core/auth-js)**           | Authentication sdk                    |
+| **[@supabase/postgrest-js](./packages/core/postgrest-js)** | PostgREST sdk for database operations |
+| **[@supabase/realtime-js](./packages/core/realtime-js)**   | Real-time subscriptions sdk           |
+| **[@supabase/storage-js](./packages/core/storage-js)**     | File storage sdk                      |
+| **[@supabase/functions-js](./packages/core/functions-js)** | Edge Functions sdk                    |
 
 > **💡 Note for Package Users:** If you install and use these packages, **nothing has changed**. Continue installing packages normally:
 >
@@ -147,12 +147,12 @@ npx nx test <package-name> --coverage
 
 ### API Documentation
 
-- **[Auth Client](./packages/core/auth-js/README.md)** - Authentication and user management
-- **[Database Client](./packages/core/postgrest-js/README.md)** - Database queries and operations
-- **[Realtime Client](./packages/core/realtime-js/README.md)** - Real-time subscriptions
-- **[Storage Client](./packages/core/storage-js/README.md)** - File upload and management
-- **[Functions Client](./packages/core/functions-js/README.md)** - Edge Functions invocation
-- **[Main Client](./packages/core/supabase-js/README.md)** - Combined client library
+- **[Auth sdk](./packages/core/auth-js/README.md)** - Authentication and user management
+- **[Database sdk](./packages/core/postgrest-js/README.md)** - Database queries and operations
+- **[Realtime sdk](./packages/core/realtime-js/README.md)** - Real-time subscriptions
+- **[Storage sdk](./packages/core/storage-js/README.md)** - File upload and management
+- **[Functions sdk](./packages/core/functions-js/README.md)** - Edge Functions invocation
+- **[Main sdk](./packages/core/supabase-js/README.md)** - Combined sdk
 
 ### Architecture Documentation
 
@@ -194,12 +194,12 @@ Because provenance attestations are a new capability, security features may evol
 supabase-js/
 ├── packages/
 │   └── core/                  # Published libraries
-│       ├── auth-js/           # Authentication client
-│       ├── functions-js/      # Edge Functions client
-│       ├── postgrest-js/      # PostgREST database client
-│       ├── realtime-js/       # Real-time subscriptions client
-│       ├── storage-js/        # File storage client
-│       └── supabase-js/       # Main isomorphic client
+│       ├── auth-js/           # Authentication sdk
+│       ├── functions-js/      # Edge Functions sdk
+│       ├── postgrest-js/      # PostgREST database sdk
+│       ├── realtime-js/       # Real-time subscriptions sdk
+│       ├── storage-js/        # File storage sdk
+│       └── supabase-js/       # Main isomorphic sdk
 ├── nx.json                    # npx nx workspace configuration
 ├── package.json               # Root package.json and workspaces setup
 └── ...
diff --git a/WARP.md b/WARP.md
@@ -4,7 +4,7 @@ This file provides guidance to WARP (warp.dev) when working with code in this re
 
 ## Repository Overview
 
-This is a unified Nx monorepo consolidating all Supabase JavaScript client libraries, built with Nx for optimal developer experience and maintainability. This strategic migration from 6 separate repositories addresses critical maintenance overhead, dependency duplication, and release coordination challenges while maintaining **zero breaking changes** for consumers.
+This is a unified Nx monorepo consolidating all Supabase JavaScript SDKs, built with Nx for optimal developer experience and maintainability. This strategic migration from 6 separate repositories addresses critical maintenance overhead, dependency duplication, and release coordination challenges while maintaining **zero breaking changes** for consumers.
 
 > **📚 Key Documentation**: For comprehensive guides, see:
 >
@@ -46,12 +46,12 @@ This monorepo replaces the following individual repositories:
 ```text
 supabase-js/
 ├── packages/core/              # Published libraries
-│   ├── supabase-js/           # Main isomorphic client for Supabase (@supabase/supabase-js)
-│   ├── auth-js/               # Authentication client (@supabase/auth-js)
-│   ├── postgrest-js/          # PostgREST client for database operations (@supabase/postgrest-js)
-│   ├── realtime-js/           # Real-time subscriptions client (@supabase/realtime-js)
-│   ├── storage-js/            # File storage client (@supabase/storage-js)
-│   └── functions-js/          # Edge Functions client (@supabase/functions-js)
+│   ├── supabase-js/           # Main isomorphic SDK for Supabase (@supabase/supabase-js)
+│   ├── auth-js/               # Authentication SDK (@supabase/auth-js)
+│   ├── postgrest-js/          # PostgREST SDK for database operations (@supabase/postgrest-js)
+│   ├── realtime-js/           # Real-time subscriptions SDK (@supabase/realtime-js)
+│   ├── storage-js/            # File storage SDK (@supabase/storage-js)
+│   └── functions-js/          # Edge Functions SDK (@supabase/functions-js)
 ├── docs/                       # Documentation guides
 │   ├── CONTRIBUTING.md         # Contribution guidelines
 │   ├── TESTING.md             # Testing guide
@@ -172,15 +172,15 @@ Each library has its own testing infrastructure. See the [TESTING.md](docs/TESTI
 
 ### Core Architecture
 
-The main `@supabase/supabase-js` package aggregates all individual client libraries:
+The main `@supabase/supabase-js` package aggregates all individual SDKs:
 
 - **auth-js**: Handles authentication and user management
 - **postgrest-js**: Provides database query capabilities via PostgREST
 - **realtime-js**: Manages real-time subscriptions and channels
 - **storage-js**: Handles file uploads and storage operations
 - **functions-js**: Invokes Supabase Edge Functions
 
-Each library is designed to work independently but integrates seamlessly when used together through the main client.
+Each library is designed to work independently but integrates seamlessly when used together through the main SDK.
 
 ### Development Infrastructure
 
@@ -259,7 +259,7 @@ nx affected --target=test
 
 | Library      | Docker Required | Primary Use Case           |
 | ------------ | --------------- | -------------------------- |
-| supabase-js  | ❌ No           | Main isomorphic client     |
+| supabase-js  | ❌ No           | Main isomorphic SDK     |
 | auth-js      | ✅ Yes          | Authentication & user mgmt |
 | postgrest-js | ✅ Yes          | Database queries           |
 | realtime-js  | ❌ No           | Real-time subscriptions    |
diff --git a/docs/MIGRATION.md b/docs/MIGRATION.md
@@ -98,7 +98,7 @@ This guide is for contributors who need to understand where code moved and how t
 
 ## Why We Migrated
 
-We converted the `supabase-js` repository into a monorepo and absorbed the other js client libraries to solve several challenges:
+We converted the `supabase-js` repository into a monorepo and absorbed the other js SDKs to solve several challenges:
 
 ### Problems with Separate Repos
 
@@ -134,7 +134,7 @@ github.com/supabase/storage-js
 github.com/supabase/functions-js
 ```
 
-**After:** The Supabase JS monorepo (absorbed all client libraries)
+**After:** The Supabase JS monorepo (absorbed all SDKs)
 
 ```tree
 github.com/supabase/supabase-js
diff --git a/packages/core/auth-js/README.md b/packages/core/auth-js/README.md
@@ -1,6 +1,6 @@
 # `auth-js`
 
-An isomorphic JavaScript client library for the [Supabase Auth](https://github.com/supabase/auth) API.
+An isomorphic JavaScript SDK for the [Supabase Auth](https://github.com/supabase/auth) API.
 
 <div align="center">
 
diff --git a/packages/core/auth-js/package.json b/packages/core/auth-js/package.json
@@ -2,7 +2,7 @@
   "name": "@supabase/auth-js",
   "version": "0.0.0",
   "private": false,
-  "description": "Official client library for Supabase Auth",
+  "description": "Official SDK for Supabase Auth",
   "keywords": [
     "auth",
     "supabase",
diff --git a/packages/core/functions-js/README.md b/packages/core/functions-js/README.md
@@ -6,7 +6,7 @@
 
 </div>
 
-JS Client library to interact with Supabase Functions.
+JS SDK to interact with Supabase Functions.
 
 ## Docs
 
diff --git a/packages/core/functions-js/package.json b/packages/core/functions-js/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@supabase/functions-js",
   "version": "0.0.0-automated",
-  "description": "JS Client library to interact with Supabase Functions.",
+  "description": "JS SDK to interact with Supabase Functions.",
   "main": "dist/main/index.js",
   "module": "dist/module/index.js",
   "types": "dist/module/index.d.ts",
diff --git a/packages/core/postgrest-js/README.md b/packages/core/postgrest-js/README.md
@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/npm/l/@supabase/postgrest-js)](#license)
 [![pkg.pr.new](https://pkg.pr.new/badge/supabase/postgrest-js)](https://pkg.pr.new/~/supabase/postgrest-js)
 
-Isomorphic JavaScript client for [PostgREST](https://postgrest.org). The goal of this library is to make an "ORM-like" restful interface.
+Isomorphic JavaScript SDK for [PostgREST](https://postgrest.org). The goal of this library is to make an "ORM-like" restful interface.
 
 Full documentation can be found [here](https://supabase.github.io/supabase-js/postgrest-js/v2/spec.json).
 
diff --git a/packages/core/realtime-js/README.md b/packages/core/realtime-js/README.md
@@ -8,7 +8,7 @@
     </picture>
   </a>
 
-  <h1 align="center">Supabase Realtime Client</h1>
+  <h1 align="center">Supabase Realtime SDK</h1>
 
   <h3 align="center">Send ephemeral messages with <b>Broadcast</b>, track and synchronize state with <b>Presence</b>, and listen to database changes with <b>Postgres Change Data Capture (CDC)</b>.</h3>
 
@@ -29,7 +29,7 @@
 
 # Overview
 
-This client enables you to use the following Supabase Realtime's features:
+This SDK enables you to use the following Supabase Realtime's features:
 
 - **Broadcast**: send ephemeral messages from client to clients with minimal latency. Use cases include sharing cursor positions between users.
 - **Presence**: track and synchronize shared state across clients with the help of CRDTs. Use cases include tracking which users are currently viewing a specific webpage.
diff --git a/packages/core/storage-js/README.md b/packages/core/storage-js/README.md
@@ -6,7 +6,7 @@
 
 </div>
 
-JS Client library to interact with Supabase Storage.
+JS SDK to interact with Supabase Storage.
 
 - Documentation: https://supabase.io/docs/reference/javascript/storage-createbucket
 - Typedoc: https://supabase.github.io/supabase-js/storage-js/v2/spec.json
@@ -393,7 +393,7 @@ The test infrastructure (`infra/docker-compose.yml`) includes:
 
 #### What About Supabase CLI?
 
-**No**, you don't need `supabase start` or a regular Supabase instance for these tests. The storage-js tests use their own specialized Docker setup that's lighter and focused specifically on testing the storage client library. This test infrastructure:
+**No**, you don't need `supabase start` or a regular Supabase instance for these tests. The storage-js tests use their own specialized Docker setup that's lighter and focused specifically on testing the storage SDK. This test infrastructure:
 
 - Is completely independent from any Supabase CLI projects
 - Uses fixed test authentication keys
diff --git a/packages/core/supabase-js/README.md b/packages/core/supabase-js/README.md
@@ -1,4 +1,4 @@
-# `supabase-js` - Isomorphic JavaScript Client for Supabase.
+# `supabase-js` - Isomorphic JavaScript SDK for Supabase.
 
 - **Documentation:** https://supabase.com/docs/reference/javascript/start
 - TypeDoc: https://supabase.github.io/supabase-js/supabase-js/v2/spec.json
diff --git a/packages/core/supabase-js/package.json b/packages/core/supabase-js/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@supabase/supabase-js",
   "version": "0.0.0-automated",
-  "description": "Isomorphic Javascript client for Supabase",
+  "description": "Isomorphic Javascript SDK for Supabase",
   "keywords": [
     "javascript",
     "typescript",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`# Contributing to Supabase JS Libraries`
`2`	`2`
`3`		`-Thank you for your interest in contributing to the Supabase JavaScript client libraries! This guide will help you get started with contributing to the Supabase JS monorepo.`
	`3`	`+Thank you for your interest in contributing to the Supabase JavaScript SDK! This guide will help you get started with contributing to the Supabase JS monorepo.`
`4`	`4`
`5`	`5`	> Repository Structure Changed: This repository has been restructured as a monorepo. All libraries, including `supabase-js`, are now under `packages/core/`. If you previously contributed to `supabase-js`, `auth-js`, `postgrest-js`, `realtime-js`, `storage-js`, or `functions-js`, please read our [Migration Guide](docs/MIGRATION.md) to understand:
`6`	`6`	`>`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@supabase/functions-js",`
`3`	`3`	`"version": "0.0.0-automated",`
`4`		`- "description": "JS Client library to interact with Supabase Functions.",`
	`4`	`+ "description": "JS SDK to interact with Supabase Functions.",`
`5`	`5`	`"main": "dist/main/index.js",`
`6`	`6`	`"module": "dist/module/index.js",`
`7`	`7`	`"types": "dist/module/index.d.ts",`