What is better-auth-referral?

This project is a plugin that adds a referral system to apps already using Better Auth, a login and account library. Instead of building your own referral tracking from scratch, you install this plugin and it handles generating referral codes, recording who invited whom, and giving you the stats to show users how many people they have brought in. Every user automatically gets a unique eight character referral code. When a new person signs up and includes that code, either through a normal email signup or through signing in with a provider like GitHub, the plugin checks that the code is valid, lets the normal signup happen, then records the connection between the person who invited and the person who joined, and creates a fresh referral code for the new user too. You can also set an optional function that runs after a successful referred signup, useful for things like giving the referrer a reward or sending a notification. If someone signs up without a code, everything works exactly as before. Once set up, any signed in user can fetch their own referral code along with simple stats such as how many people joined today and how many joined overall. There is also an endpoint to list everyone a given user has referred, with support for paging through longer lists and an option to partially hide referred users' email addresses for privacy. Setting it up means installing the package and its two required companion libraries, adding a server side plugin to your Better Auth configuration, adding a matching client side plugin, and then running your normal Better Auth database setup steps so two new tables for referral codes and referrals get created. The referral code that gets checked during signup can be sent under a different header name if you prefer, and the whole thing is released under the MIT license.