The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
docs: Update documentation from SDK changes (Jan 2026) (#42085)
Guilherme Souzae51f24448d22
diff --git a/apps/docs/content/guides/auth/social-login/auth-twitter.mdx b/apps/docs/content/guides/auth/social-login/auth-twitter.mdxindex fde1411b01e..085ab650f51 100644--- a/apps/docs/content/guides/auth/social-login/auth-twitter.mdx+++ b/apps/docs/content/guides/auth/social-login/auth-twitter.mdx@@ -120,6 +120,19 @@ Future<void> signInWithX() async {```</TabPanel>+<$Show if="sdk:swift">+<TabPanel id="swift" label="Swift">++When your user signs in, call [`signInWithOAuth(provider:)`](/docs/reference/swift/auth-signinwithoauth) with `.x` as the `provider`:++```swift+func signInWithX() async throws {+ try await supabase.auth.signInWithOAuth(provider: .x)+}+```++</TabPanel>+</$Show><$Show if="sdk:kotlin"><TabPanel id="kotlin" label="Kotlin">@@ -173,6 +186,19 @@ Future<void> signOut() async {```</TabPanel>+<$Show if="sdk:swift">+<TabPanel id="swift" label="Swift">++When your user signs out, call [signOut()](/docs/reference/swift/auth-signout) to remove them from the browser session:++```swift+func signOut() async throws {+ try await supabase.auth.signOut()+}+```++</TabPanel>+</$Show><$Show if="sdk:kotlin"><TabPanel id="kotlin" label="Kotlin">diff --git a/apps/docs/content/guides/storage/debugging/error-codes.mdx b/apps/docs/content/guides/storage/debugging/error-codes.mdxindex 6a962f11e91..ff7f809531c 100644--- a/apps/docs/content/guides/storage/debugging/error-codes.mdx+++ b/apps/docs/content/guides/storage/debugging/error-codes.mdx@@ -6,6 +6,52 @@ subtitle: 'Learn about the Storage error codes and how to resolve them'sidebar_label: 'Debugging'---+## Handling Storage errors in SDKs++When using the Supabase SDKs, storage errors provide detailed information to help you debug issues:++<Tabs+ scrollable+ size="small"+ type="underlined"+ defaultActiveId="js"+ queryGroup="language"+>+<TabPanel id="js" label="JavaScript">++```js+try {+ const { data, error } = await supabase.storage.from('avatars').download('avatar.png')++ if (error) {+ // Access error details+ console.log('Error code:', error.error)+ console.log('Error message:', error.message)+ console.log('HTTP status:', error.status)+ console.log('Status code:', error.statusCode)+ }+} catch (err) {+ console.error('Unexpected error:', err)+}+```++</TabPanel>+<$Show if="sdk:python">+<TabPanel id="python" label="Python">++```python+try:+ response = supabase.storage.from_('avatars').download('avatar.png')+except Exception as error:+ # Access error details+ print(f'Error: {error}')+ # The SDK now handles bad responses from the server gracefully+```++</TabPanel>+</$Show>+</Tabs>+## Storage error codes<Admonition type="note">diff --git a/apps/docs/content/guides/storage/serving/downloads.mdx b/apps/docs/content/guides/storage/serving/downloads.mdxindex 6f2c891c066..4bf08585f65 100644--- a/apps/docs/content/guides/storage/serving/downloads.mdx+++ b/apps/docs/content/guides/storage/serving/downloads.mdx@@ -35,6 +35,71 @@ If you want the browser to start an automatic download of the asset instead of tBy default it will use the asset name to save the file on disk. You can optionally pass a custom name to the `download` parameter as following: `?download=customname.jpg`+#### Programmatic downloads with query parameters++When using the SDK's `download()` method, you can pass additional query parameters to customize the download behavior:++<Tabs+ scrollable+ size="small"+ type="underlined"+ defaultActiveId="js"+ queryGroup="language"+>+<TabPanel id="js" label="JavaScript">++```js+import { createClient } from '@supabase/supabase-js'+const supabase = createClient('your_project_url', 'your_supabase_api_key')++// ---cut---+// Download with custom filename+const { data, error } = await supabase.storage.from('avatars').download('avatar1.png', {+ download: 'my-custom-name.png',+})+```++</TabPanel>+<$Show if="sdk:dart">+<TabPanel id="dart" label="Dart">++```dart+// Download with additional query parameters+final response = await supabase.storage+ .from('avatars')+ .download(+ 'avatar1.png',+ queryParams: {+ 'download': 'my-custom-name.png',+ },+ );+```++[Reference.](/docs/reference/dart/storage-from-download)++</TabPanel>+</$Show>+<$Show if="sdk:swift">+<TabPanel id="swift" label="Swift">++```swift+// Download with additional query parameters+let response = try await supabase.storage+ .from("avatars")+ .download(+ path: "avatar1.png",+ queryItems: [+ URLQueryItem(name: "download", value: "my-custom-name.png")+ ]+ )+```++[Reference.](/docs/reference/swift/storage-from-download)++</TabPanel>+</$Show>+</Tabs>+## Private bucketsAssets stored in a non-public bucket are considered private and are not accessible via a public URL like the public buckets.