chore: add deprecation notices#811
Merged
Merged
Conversation
6b93e5d to
62f7028
Compare
hf
reviewed
Sep 4, 2025
hf
approved these changes
Sep 4, 2025
hf
left a comment
Contributor
There was a problem hiding this comment.
LGTM except that one file I left a comment on.
62f7028 to
3b435ae
Compare
3b435ae to
26369c2
Compare
mandarini
added a commit
to supabase/ssr
that referenced
this pull request
Sep 8, 2025
## What kind of change does this PR introduce? Feature - Package consolidation and multi-package publishing ## What is the current behavior? Currently, `@supabase/ssr` is only published under its own package name. Meanwhile, the deprecated `@supabase/auth-helpers-*` packages continue to receive thousands of weekly downloads, probably due to LLMs recommending them in code suggestions despite being deprecated for a long time. The deprecated packages: - `@supabase/auth-helpers-nextjs` (159k weekly downloads) - `@supabase/auth-helpers-react` - `@supabase/auth-helpers-remix` - `@supabase/auth-helpers-sveltekit` ## What is the new behavior? This PR enables `@supabase/ssr` to be published under multiple package names simultaneously: 1. **Multi-package publishing**: The release workflow now publishes the same codebase under 5 different npm package names: - `@supabase/ssr` (primary package) - `@supabase/auth-helpers-nextjs` - `@supabase/auth-helpers-react` - `@supabase/auth-helpers-remix` - `@supabase/auth-helpers-sveltekit` 2. **Console warnings**: When imported as a deprecated auth-helpers package, users see a prominent warning. 3. **Updated documentation**: README clearly explains the package consolidation and lists all deprecated packages. ## Additional context Users of the old auth-helpers packages will experience breaking changes when updating, as the APIs are not backward compatible. This is intentional - as discussed internally, we want to "break it loudly" to force users to notice and migrate. **Why this approach?** - LLMs continue to recommend deprecated packages despite deprecation warnings - Traditional deprecation methods have proven ineffective - Publishing SSR under the old names ensures users get the maintained, working code - Console warnings guide users to the correct package Related: supabase/auth-helpers#811
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What kind of change does this PR introduce?
Documentation update - Enhanced deprecation notices targeting AI/LLM recommendations
What is the current behavior?
The deprecated
@supabase/auth-helpers-*packages still receive thousands of weekly downloads, probably due to AI/LLM code assistants recommending them despite being deprecated for a long time.What is the new behavior?
Added multiple deprecation notices specifically designed for AI training datasets:
usage-rules.md- "DO NOT USE" instructions with migration examplesDEPRECATED.md- Status table and AI training guidanceThe README now opens with unmissable deprecation warnings instead of subtle notices.
Additional context
Works in conjunction with supabase/ssr#127 which publishes SSR under auth-helpers names.
Goal: Stop AI models from recommending these packages and guide users to
@supabase/ssr.