[pull] master from supabase:master

.cursor/rules/studio-ui.mdc

@@ -128,6 +128,7 @@ export const MyPageComponent = () => (
 - Use our `_Shadcn_` form primitives from `ui` and prefer `FormItemLayout` with layout="flex-row-reverse" for most controls (see `apps/studio/components/interfaces/Settings/Integrations/GithubIntegration/GitHubIntegrationConnectionForm.tsx`).
 - Keep imports from `ui` with `_Shadcn_` suffixes.
 - Forms should generally be wrapped in a Card unless specified
+- If the submit button is outside the form, add a new variable named formId outside the component, and set it as property id on the form element and formId on the button.
 
 ### Example (single field)
 
@@ -143,6 +144,8 @@ const profileSchema = z.object({
   username: z.string().min(2, 'Username must be at least 2 characters'),
 })
 
+const formId = `profile-form`
+
 export function ProfileForm() {
   const form = useForm<z.infer<typeof profileSchema>>({
     resolver: zodResolver(profileSchema),
@@ -200,6 +203,11 @@ export function ProfileForm() {
 
 - Use a sheet when needing to reveal more complicated forms or information relating to an object and context switching away to a new page would be disruptive e.g. we list auth providers, clicking an auth provider opens a sheet with information about that provider and a form to enable, user can close sheet to go back to providers list
 
+## React Query
+
+- When doing a mutation, always use the mutate function. Always use onSuccess and onError with a toast.success and toast.error.
+- Use mutateAsync only if the mutation is part of multiple async actions. Wrap the mutateAsync call with try/catch block and add toast.success and toast.error.
+
 ## Tables
 
 - Use the generic ui table components for most tables

.github/workflows/docs-sync-auto-troubleshooting.yml

@@ -0,0 +1,72 @@
+# Sync AI-generated troubleshooting guides from supabase/troubleshooting
+
+name: Sync from supabase/troubleshooting
+
+on:
+  repository_dispatch:
+    types: [sync_from_upstream]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout supabase/supabase
+        uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
+        with:
+          persist-credentials: true
+
+      - name: Decode the GitHub App Private Key
+        id: decode
+        run: |
+          private_key=$(echo "${{ secrets.DOCS_GITHUB_APP_PRIVATE_KEY }}" | base64 --decode | awk 'BEGIN {ORS="\\n"} {print}' | head -c -2) &> /dev/null
+          echo "::add-mask::$private_key"
+          echo "private-key=$private_key" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub App token for supabase/troubleshooting
+        id: app-token
+        uses: actions/create-github-app-token@67018539274d69449ef7c02e8e71183d1719ab42 # v2.1.4
+        with:
+          app-id: ${{ vars.DOCS_GITHUB_APP_ID }}
+          private-key: ${{ steps.decode.outputs.private-key }}
+          repositories: troubleshooting
+          permission-contents: read
+
+      - name: Checkout supabase/troubleshooting
+        uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
+        with:
+          persist-credentials: false
+          token: ${{ steps.app-token.outputs.token }}
+          repository: supabase/troubleshooting
+          path: troubleshooting-upstream
+
+      - name: Sync supabase/troubleshooting changes back to supabase/supabase
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config user.name 'github-docs-bot'
+          git config user.email 'github-docs-bot@supabase.com'
+          BRANCH_NAME="bot/sync-troubleshooting"
+          EXISTING_BRANCH=$(git ls-remote --heads origin $BRANCH_NAME)
+          if [[ -n "$EXISTING_BRANCH" ]]; then
+              git push origin --delete $BRANCH_NAME
+          fi
+          git checkout -b $BRANCH_NAME
+          rsync --archive --verbose --ignore-existing ./troubleshooting-upstream/guides/ ./apps/docs/content/troubleshooting/
+          git add apps/docs/content/troubleshooting/
+          if git diff --quiet --cached; then
+            echo "No changes to sync"
+            exit 0
+          fi
+          git commit --message "Sync from supabase/troubleshooting"
+          git push origin $BRANCH_NAME
+          if gh pr list --state open --head $BRANCH_NAME --json number --jq '.[0].number' | grep -q .; then
+            gh pr comment "$BRANCH_NAME" --body "Updated troubleshooting sync with latest changes."
+          else
+            gh pr create --title "[bot] Sync from supabase/troubleshooting" --body "This PR syncs the latest troubleshooting guides from the supabase/troubleshooting repository." --head $BRANCH_NAME
+          fi

apps/docs/app/contributing/ContributingToC.tsx

@@ -14,7 +14,7 @@ interface TocItem extends HTMLAttributes<HTMLElement> {
 }
 
 export function ContributingToc({ className }: { className?: string }) {
-  const mobileToc = useBreakpoint('xl')
+  const mobileToc = useBreakpoint('lg')
   const [tocItems, setTocItems] = useState<Array<TocItem>>([])
 
   useEffect(() => {

apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts

@@ -697,6 +697,7 @@ export const auth: NavMenuConstant = {
           name: 'Sessions',
           url: '/guides/auth/sessions',
           items: [
+            { name: 'User sessions', url: '/guides/auth/sessions' },
             { name: 'Implicit flow', url: '/guides/auth/sessions/implicit-flow' },
             { name: 'PKCE flow', url: '/guides/auth/sessions/pkce-flow' },
           ],
@@ -711,6 +712,7 @@ export const auth: NavMenuConstant = {
           name: 'Server-Side Rendering',
           url: '/guides/auth/server-side',
           items: [
+            { name: 'Overview', url: '/guides/auth/server-side' },
             { name: 'Next.js guide', url: '/guides/auth/server-side/nextjs' },
             {
               name: 'SvelteKit guide',
@@ -746,7 +748,7 @@ export const auth: NavMenuConstant = {
         {
           name: 'Social Login (OAuth)',
           url: '/guides/auth/social-login',
-          items: [...SocialLoginItems],
+          items: [{ name: 'Overview', url: '/guides/auth/social-login' }, ...SocialLoginItems],
           enabled: allAuthProvidersEnabled,
         },
 
@@ -755,6 +757,7 @@ export const auth: NavMenuConstant = {
           url: '/guides/auth/enterprise-sso',
           enabled: allAuthProvidersEnabled,
           items: [
+            { name: 'Overview', url: '/guides/auth/enterprise-sso' },
             {
               name: 'SAML 2.0',
               url: '/guides/auth/enterprise-sso/auth-sso-saml' as `/${string}`,
@@ -781,6 +784,7 @@ export const auth: NavMenuConstant = {
           name: 'Multi-Factor Authentication',
           url: '/guides/auth/auth-mfa',
           items: [
+            { name: 'Overview', url: '/guides/auth/auth-mfa' },
             { name: 'App Authenticator (TOTP)', url: '/guides/auth/auth-mfa/totp' },
             { name: 'Phone', url: '/guides/auth/auth-mfa/phone' },
           ],
@@ -831,6 +835,7 @@ export const auth: NavMenuConstant = {
           name: 'Auth Hooks',
           url: '/guides/auth/auth-hooks',
           items: [
+            { name: 'Overview', url: '/guides/auth/auth-hooks' },
             {
               name: 'Custom access token hook',
               url: '/guides/auth/auth-hooks/custom-access-token-hook' as `/${string}`,
@@ -880,7 +885,10 @@ export const auth: NavMenuConstant = {
           name: 'JSON Web Tokens (JWT)',
           url: '/guides/auth/jwts',
           enabled: authFullSecurityEnabled,
-          items: [{ name: 'Claims Reference', url: '/guides/auth/jwt-fields' }],
+          items: [
+            { name: 'Overview', url: '/guides/auth/jwts' },
+            { name: 'Claims Reference', url: '/guides/auth/jwt-fields' },
+          ],
         },
         {
           name: 'JWT Signing Keys',
@@ -921,6 +929,7 @@ const ormQuickstarts: NavMenuSection = {
       name: 'Prisma',
       url: '/guides/database/prisma',
       items: [
+        { name: 'Connecting with Prisma', url: '/guides/database/prisma' as `/${string}` },
         {
           name: 'Prisma troubleshooting',
           url: '/guides/database/prisma/prisma-troubleshooting' as `/${string}`,
@@ -2008,7 +2017,13 @@ export const ai: NavMenuConstant = {
         {
           name: 'Vector indexes',
           url: '/guides/ai/vector-indexes',
-          items: vectorIndexItems,
+          items: [
+            {
+              name: 'Overview',
+              url: '/guides/ai/vector-indexes',
+            },
+            ...vectorIndexItems,
+          ],
         },
         {
           name: 'Automatic embeddings',
@@ -2355,6 +2370,10 @@ export const platform: NavMenuConstant = {
           name: 'Migrating within Supabase',
           url: '/guides/platform/migrating-within-supabase',
           items: [
+            {
+              name: 'Overview',
+              url: '/guides/platform/migrating-within-supabase' as `/${string}`,
+            },
             {
               name: 'Restore Dashboard backup',
               url: '/guides/platform/migrating-within-supabase/dashboard-restore' as `/${string}`,
@@ -2368,7 +2387,10 @@ export const platform: NavMenuConstant = {
         {
           name: 'Migrating to Supabase',
           url: '/guides/platform/migrating-to-supabase',
-          items: MIGRATION_PAGES,
+          items: [
+            { name: 'Overview', url: '/guides/platform/migrating-to-supabase' as `/${string}` },
+            ...MIGRATION_PAGES,
+          ],
         },
       ],
     },
@@ -2385,6 +2407,10 @@ export const platform: NavMenuConstant = {
           url: '/guides/platform/multi-factor-authentication',
           enabled: fullPlatformEnabled,
           items: [
+            {
+              name: 'Overview',
+              url: '/guides/platform/multi-factor-authentication' as `/${string}`,
+            },
             {
               name: 'Enforce MFA on organization',
               url: '/guides/platform/mfa/org-mfa-enforcement' as `/${string}`,
@@ -2405,6 +2431,7 @@ export const platform: NavMenuConstant = {
           url: '/guides/platform/sso',
           enabled: fullPlatformEnabled,
           items: [
+            { name: 'Overview', url: '/guides/platform/sso' as `/${string}` },
             { name: 'SSO with Azure AD', url: '/guides/platform/sso/azure' },
             {
               name: 'SSO with Google Workspace',
@@ -2463,8 +2490,12 @@ export const platform: NavMenuConstant = {
         },
         {
           name: 'Manage your usage',
-          url: '/guides/platform/manage-your-usage' as `/${string}`,
+          url: '/guides/platform/manage-your-usage',
           items: [
+            {
+              name: 'Overview',
+              url: '/guides/platform/manage-your-usage' as `/${string}`,
+            },
             {
               name: 'Compute',
               url: '/guides/platform/manage-your-usage/compute' as `/${string}`,
@@ -2563,6 +2594,10 @@ export const platform: NavMenuConstant = {
           name: 'AWS Marketplace',
           url: '/guides/platform/aws-marketplace',
           items: [
+            {
+              name: 'Overview',
+              url: '/guides/platform/aws-marketplace' as `/${string}`,
+            },
             {
               name: 'Getting Started',
               url: '/guides/platform/aws-marketplace/getting-started',
@@ -2804,6 +2839,10 @@ export const integrations: NavMenuConstant = {
           name: 'Build a Supabase integration',
           url: '/guides/integrations/build-a-supabase-integration',
           items: [
+            {
+              name: 'Overview',
+              url: '/guides/integrations/build-a-supabase-integration' as `/${string}`,
+            },
             {
               name: 'OAuth scopes',
               url: '/guides/integrations/build-a-supabase-integration/oauth-scopes' as `/${string}`,

apps/docs/content/_partials/oauth_pkce_flow.mdx

@@ -123,12 +123,12 @@ export const GET = async (event) => {
   if (code) {
     const { error } = await supabase.auth.exchangeCodeForSession(code)
     if (!error) {
-      throw redirect(303, `/${next.slice(1)}`);
+      redirect(303, `/${next.slice(1)}`);
     }
   }
 
   // return the user to an error page with instructions
-  throw redirect(303, '/auth/auth-code-error');
+  redirect(303, '/auth/auth-code-error');
 };
 ```
 

apps/docs/content/guides/getting-started/quickstarts/sveltekit.mdx

@@ -67,8 +67,8 @@ hideToc: true
       <$CodeTabs>
 
         ```text name=.env
-        VITE_PUBLIC_SUPABASE_URL=<SUBSTITUTE_SUPABASE_URL>
-        VITE_PUBLIC_SUPABASE_PUBLISHABLE_KEY=<SUBSTITUTE_SUPABASE_PUBLISHABLE_KEY>
+        PUBLIC_VITE_SUPABASE_URL=<SUBSTITUTE_SUPABASE_URL>
+        PUBLIC_VITE_SUPABASE_PUBLISHABLE_KEY=<SUBSTITUTE_SUPABASE_PUBLISHABLE_KEY>
         ```
 
       </$CodeTabs>
@@ -90,16 +90,16 @@ hideToc: true
 
         ```js name=src/lib/supabaseClient.js
           import { createClient } from '@supabase/supabase-js';
-        import { VITE_PUBLIC_SUPABASE_URL, VITE_PUBLIC_SUPABASE_PUBLISHABLE_KEY } from '$env/static/public';
+        import { PUBLIC_VITE_SUPABASE_URL, PUBLIC_VITE_SUPABASE_PUBLISHABLE_KEY } from '$env/static/public';
 
-        export const supabase = createClient(VITE_PUBLIC_SUPABASE_URL, VITE_PUBLIC_SUPABASE_PUBLISHABLE_KEY)
+        export const supabase = createClient(PUBLIC_VITE_SUPABASE_URL, PUBLIC_VITE_SUPABASE_PUBLISHABLE_KEY)
         ```
 
         ```ts name=src/lib/supabaseClient.ts
           import { createClient } from '@supabase/supabase-js';
-        import { VITE_PUBLIC_SUPABASE_URL, VITE_PUBLIC_SUPABASE_PUBLISHABLE_KEY } from '$env/static/public';
+        import { PUBLIC_VITE_SUPABASE_URL, PUBLIC_VITE_SUPABASE_PUBLISHABLE_KEY } from '$env/static/public';
 
-        export const supabase = createClient(VITE_PUBLIC_SUPABASE_URL, VITE_PUBLIC_SUPABASE_PUBLISHABLE_KEY)
+        export const supabase = createClient(PUBLIC_VITE_SUPABASE_URL, PUBLIC_VITE_SUPABASE_PUBLISHABLE_KEY)
         ```
 
       </$CodeTabs>

apps/docs/content/guides/local-development/cli/testing-and-linting.mdx

@@ -28,7 +28,7 @@ Our friends at [Basejump](https://usebasejump.com/) have created a useful set of
 
 ### Running database tests in CI
 
-Use our GitHub Action to [automate your database tests](/docs/guides/cli/github-action/testing#testing-your-database).
+Use our GitHub Action to [automate your database tests](/docs/guides/deployment/ci/testing).
 
 ## Testing your Edge Functions