Money · Edition No. 31 · 25 Sep 2026

amicalhq/refref

A referral and affiliate programme you run on your own server.

← MoneyRead the whole edition →
12

amicalhq/refref

💎 hidden gem

216 stars · AGPL-3.0 · no releases; 113 commits · Track this in Scout

Open-source referral and affiliate programmes — attribution, incentives and a partner portal.

▶Repo detailsthe review · specs · pros & cons · install

What it is

RefRef is a self-hosted referral platform written in TypeScript on Next.js and PostgreSQL. It issues referral links, attributes signups and purchases to the person who sent them, calculates rewards under rules you set, and gives partners a portal showing what they have earned.

What it is good for. A small business paying a monthly fee for a referral service, or one that has put off starting a referral programme because the tools are priced for larger companies. Running it yourself also means the customer list stays on your own machine.

Stars216
LicenceAGPL-3.0
Latestno releases; 113 commitschecked 7 Sep 2026
Written inTypeScript
Good
  • The only open-source project in this category this report has managed to find in thirty-one editions. Everything else here is a paid service.
  • Attribution, reward rules, fraud checks and a partner portal are all in the one project, so there is nothing to stitch together.
  • Built on ordinary parts — Next.js and PostgreSQL — so anyone who has run a web application can run it.
Watch for
  • 222 stars and no releases at all. There is no version to pin, so an install means choosing a commit and writing it down. Code last landed on 20 March 2026.
  • AGPL-3.0. If you change it and offer it to other people over a network, you have to publish your changes. For running it as part of your own business that is usually fine; for embedding it in a product you sell, read the licence first.
  • It is young. Expect gaps, expect to read the source, and do not make it the only record of who is owed money.
Install
git clone https://github.com/amicalhq/refref.git
cd refref
# it needs Node.js and a PostgreSQL database
cp .env.example .env          # then set DATABASE_URL and the app URL
npm install
npm run db:push
npm run dev                   # http://localhost:3000
Screenshots
amicalhq/refref: GitHub preview cardamicalhq/refref: Screenshot 1amicalhq/refref: Screenshot 2

Get the next edition in your inbox

A dozen repositories, opened and checked. The licence read, the last release dated, and the ones that did not make it named with the reason. It is the half most lists leave out.

No tracking pixels. One click to leave. The archive stays free either way.

We use your address to send the edition and nothing else. Confirm by email, leave in one click. How we handle it.