supabase/supabase

Clarify when to use `getClaims` and `getUser` and discourage usage of `getSession`

Open

#40.985 aberto em 30 de out. de 2025

Ver no GitHub
 (50 comments) (1 reaction) (1 assignee)TypeScript (102.348 stars) (12.387 forks)batch import
documentationexternal-issuehelp wantedp1plannedto-triage

Description

Documentation is

  • Missing
  • Outdated
  • Confusing
  • Not sure?

Explain in Detail

All of the Server Framework Documentation still uses getUser() by default, which means there is an extraneous call to the database. Supabase created getClaims() for this purpose increasing the speed and security of Supabase Auth.

The docs should reflect this by default.

Outdated Setup

No Server Setup At All

  • Nuxt - this doesn't even have a server endpoint setup and is just a Vue setup
  • SolidJS - There should be a SolidStart version for server

The @supabase/ssr makes it easy to add functionality to any framework, and could easily be used in place of outdated addons like:

I am happy to help create a demo for all of these if necessary (just let me know), but first SvelteKit and NextJS docs need to be updated with getClaims() instead of getUser(), and before getClaims() can be useful, the typing problem should be fixed.

J

Your Suggestion for Changes

No response

Documentation URL

No response

Steps to reproduce

No response

Guia do colaborador

Pilha de tecnologia
typescriptjavascriptnextjssveltenuxtsolidjs
Domain
documentationauthentication
Tipo Issue
documentation
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
half day
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
active
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
clear
Prerequisites
Understanding of Supabase Auth flowsFamiliarity with Next.js and SvelteKit documentationBasic knowledge of JWT claims
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
60
Direção de pesquisa
Review the current server framework documentation for Next.js, SvelteKit, Nuxt, and SolidJS as noted in the issue. Update all instances of `getUser()` to `getClaims()` where appropriate, noting the typing issue in supabase js (#1584) that must be resolved first. For Nuxt and SolidJS, consider adding server endpoint setup examples similar to the existing ones. Also consider creating demos for Qwik and Nuxt as suggested.