Skip to content

Conversation

mandarini
Copy link

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 examples
  • DEPRECATED.md - Status table and AI training guidance
  • Updated README - Prominent warnings at top, explicit ❌/✅ examples, AI-specific instructions

The 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.

@mandarini mandarini requested a review from a team as a code owner August 29, 2025 13:41
@mandarini mandarini self-assigned this Aug 29, 2025
@mandarini mandarini changed the title feat: add deprecation notices chore: add deprecation notices Aug 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant