PHPackages                             martechmagicians/referhub - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. martechmagicians/referhub

ActiveProject[Utility & Helpers](/categories/utility)

martechmagicians/referhub
=========================

ReferHub is a modular and composable referral system, designed to seamlessly generate and track referral codes for users. With support for various identification methods and a flexible event-tracking system, ReferHub provides an extensible solution for managing referrals across different platforms. Its event-driven architecture enables webhook integrations, making it adaptable to diverse use cases. Whether you're implementing a user sign-up referral program or tracking purchases, ReferHub offers a robust and maintainable foundation. Built with DDD and TDD principles, it emphasizes quality, scalability, and ease of integration. Ideal for developers seeking a referral solution that can be effortlessly embedded into existing systems or customized to specific needs.

v1.0.0(2y ago)02proprietaryPHPPHP >=8.2

Since Jul 29Pushed 2y ago1 watchersCompare

[ Source](https://github.com/MarTechMagicians/referhub)[ Packagist](https://packagist.org/packages/martechmagicians/referhub)[ RSS](/packages/martechmagicians-referhub/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (23)Versions (16)Used By (0)

ReferHub
========

[](#referhub)

ReferHub is a modular and composable referral software designed to generate and manage referral codes, track events, and handle webhooks. Built with Symfony and following DDD and TDD principles, ReferHub offers a flexible and maintainable solution for developers and businesses.

Features
--------

[](#features)

- **Referral Code Generation:** Generate referral codes for users identified by email, username, or userId.
- **Event Tracking:** Track generic events like Sign Up, Purchase, and more.
- **Webhook Integration:** Trigger webhooks when tracked events occur.
- **CLI, REST, and Batch API Support:** Flexible API interfaces for various integration needs.
- **Open Source:** Contribute and customize to fit your unique requirements.

Installation
------------

[](#installation)

### Requirements

[](#requirements)

- Docker (required to run the project)

### Steps

[](#steps)

1. **Clone the Repository:**

    ```
    git clone https://github.com/yourusername/referhub.git
    ```
2. **Navigate to the Project Directory:**

    ```
    cd referhub
    ```
3. **Configure Environment Variables:** Copy the `.env` file to the `.env.local` file with your database and other configurations.
4. **Build the Project:**

    ```
    make build
    ```
5. **Run the containers :**

    ```
    make up
    ```
6. **Create the db:**

    ```
    make db-create
    ```
7. **Run db migrations:**

    ```
    make db-migrate
    ```

Usage
-----

[](#usage)

Refer to the [API documentation](doc/API%20Specifications.md) for details on interacting with ReferHub via REST API.

Contributing
------------

[](#contributing)

We welcome contributions!

Support
-------

[](#support)

For support, please open an issue on GitHub or contact the maintainers.

License
-------

[](#license)

ReferHub is released under the [GNU License](LICENSE.md).

Acknowledgments
---------------

[](#acknowledgments)

Special thanks to the community and everyone who has contributed to this project.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1009d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/71869c934eb87ca6592d7e98a776157d74faff5c0f0c28a0986c390f294c8511?d=identicon)[martechmagicians](/maintainers/martechmagicians)

---

Top Contributors

[![MarTechMagicians](https://avatars.githubusercontent.com/u/140889725?v=4)](https://github.com/MarTechMagicians "MarTechMagicians (32 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/martechmagicians-referhub/health.svg)

```
[![Health](https://phpackages.com/badges/martechmagicians-referhub/health.svg)](https://phpackages.com/packages/martechmagicians-referhub)
```

###  Alternatives

[easycorp/easyadmin-demo

EasyAdmin Demo Application

145.7k](/packages/easycorp-easyadmin-demo)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M647](/packages/sylius-sylius)[kadirov/api-starter-kit

443.9k](/packages/kadirov-api-starter-kit)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)