{"repo":"amicalhq/refref","free":true,"listed":false,"github":"https://github.com/amicalhq/refref","clone":"git clone https://github.com/amicalhq/refref.git","description":"🌟 Open Source Referral and Affiliate Marketing Platform - Launch your referral program in minutes!","language":"TypeScript","stars":213,"topics":["drizzle","fumadocs","nextjs","referral-platform","referrals","self-hosted","typescript","affiliate","affiliate-marketing","loyalty"],"license":"AGPL-3.0","category":"self-hosted-apps","readme_excerpt":"Website - Docs - Community - Bug reports Table of Contents - 🔮 Overview - 🚀 Getting Started - ✨ Features - 🔰 Tech Stack - 🤗 Contributing - 🎗 License [!CAUTION] RefRef is still in alpha, expect bugs and breaking changes. 🔮 Overview Build powerful referral programs for your products with RefRef's open source referral management platform. 🚀 Getting Started Quick Start with Docker (Recommended) Get RefRef running in under a minute: That's it! 🎉 The webapp portal will be available at http://localhost:3000. Docker Compose automatically handles: - PostgreSQL database setup - Database migrations - Initial data seeding - Webapp portal configuration To configure optional services (Google OAuth, email), pass environment variables: Local Development Setup If you prefer running RefRef locally without Docker: Prerequisites - Node.js 20+ - pnpm 10.23.0 - PostgreSQL database - portless ( npm install -g portless ) Installation Each app gets a stable .localhost URL via portless: App URL ------ ----------------------------------- Webapp http://refref-webapp.localhost:1355 WWW http://refref-www.localhost:1355 API http://refref-api.localhost:1355 Refer http://refref-refer.localhost:1355 Acme http://refref-acme.localhost:1355 Portless is a global CLI tool ( npm install -g portless ). The proxy auto-starts when you run pnpm dev . To bypass portless, set PORTLESS=0 pnpm dev . Environment Variables Required - DATABASE URL - PostgreSQL connection string (e.g., postgresql://user:password@localh","default_branch":null,"files":null,"tree":[],"storefront":"/r/amicalhq","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/amicalhq/refref/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}