{"id":27063765,"url":"https://github.com/ecstaticfly/referralhub","last_synced_at":"2026-04-04T08:36:08.790Z","repository":{"id":286150036,"uuid":"955388649","full_name":"EcstaticFly/ReferralHub","owner":"EcstaticFly","description":"ReferralHub is a MERN stack platform designed to streamline and manage referral-based campaigns. It allows businesses to create campaigns, track referrals, and analyze campaign performance while providing users with an easy way to participate in referral programs..","archived":false,"fork":false,"pushed_at":"2025-04-04T15:52:46.000Z","size":517,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T16:42:12.656Z","etag":null,"topics":["chatbot","expressjs","gemini-api","jwt","mongodb","nodejs","reactjs","responsive-design","smtp","tailwindcss","vercel-deployment","vite","zustand"],"latest_commit_sha":null,"homepage":"https://referral-hub-alpha.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EcstaticFly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-26T15:03:10.000Z","updated_at":"2025-04-04T15:52:50.000Z","dependencies_parsed_at":"2025-04-04T16:42:20.520Z","dependency_job_id":"41e12d66-401a-4c41-8b9f-19a54ee50fe6","html_url":"https://github.com/EcstaticFly/ReferralHub","commit_stats":null,"previous_names":["ecstaticfly/referralhub"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EcstaticFly%2FReferralHub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EcstaticFly%2FReferralHub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EcstaticFly%2FReferralHub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EcstaticFly%2FReferralHub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EcstaticFly","download_url":"https://codeload.github.com/EcstaticFly/ReferralHub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247362600,"owners_count":20926807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","expressjs","gemini-api","jwt","mongodb","nodejs","reactjs","responsive-design","smtp","tailwindcss","vercel-deployment","vite","zustand"],"created_at":"2025-04-05T16:20:55.821Z","updated_at":"2025-12-30T19:03:33.548Z","avatar_url":"https://github.com/EcstaticFly.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 ReferralHub – Referral Management Platform\n\nReferralHub is a **full-stack referral management platform** that allows businesses to **create, manage, and monitor referral campaigns**, while enabling users to **participate and share personalized referral links**. Built using the **MERN stack with Zustand, and Vercel**, the platform is scalable, secure, and designed for high performance.\n\n🔗 **Live Demo:** [ReferralHub](https://referral-hub-alpha.vercel.app/)  \n📂 **Source Code:** [GitHub](https://github.com/EcstaticFly/ReferralHub.git)\n\n## ✨ Features\n- 🧠 **Campaign Management** – Businesses can create, edit, and expire referral campaigns.\n- 🔗 **User Referrals** – Users receive **unique referral links** to invite others.\n- 📊 **Dashboard Analytics** – Monitor referral performance \u0026 campaign stats.\n- 🧾 **Referral History** – View all referred users and rewards per campaign.\n- 🔒 **JWT Auth \u0026 Cookies** – Secure **authentication and session handling**.\n- 💻 **Responsive Design** – Built with **TailwindCSS** for full responsiveness.\n\n\n## 🛠 Tech Stack\n\n- **Frontend:** React.js, Zustand, TailwindCSS  \n- **Backend:** Node.js (ES Modules), Express.js, MongoDB (Mongoose)  \n- **Authentication:** JWT, Cookies  \n- **Deployment:** Vercel  \n\n## 🚀 Installation \u0026 Setup\n\n1️⃣ **Clone the repository:**\n   ```bash\n   git clone https://github.com/EcstaticFly/ReferralHub.git\n   cd ReferralHub\n   ```\n\n2️⃣ **Configure server environment variables**\n```bash\n#setup .env file for server\ncd server\ntouch .env\n#add in server/.env\nREACT_MONGODB_URL=your_mongodb_url\nCLIENT_BASE_URL=your_cors_origin\nJWT_SECRET=your_jwt_secret\nNODE_ENV=development\nMAIL_USER=your_mail_service_email\nSECRET_PASSWORD=your_mail_service_password\nGEMINI_API_KEY=AIzaSyBmUPvJ3EnJBKzKYjUmtYQV9GrSHAXEzAA\n```\n\n3️⃣ **Configure client environment variable**\n```bash\n#setup .env file for client\ncd client\ntouch .env\n#add in client/.env\nVITE_API_URL=your_backend_api_url\n```\n\n4️⃣ **Run the app**\n```bash\n#start server\ncd server\nnpm run dev\n#start client\ncd client\nnpm run dev\n```\n\nThe app will be live at http://localhost:5173\n\n## 🤝 Contributing\n\nContributions, issues, and feature requests are welcome!  \nFeel free to **fork** the repo and submit a **pull request**.\n\n## 📜 License\nThis project is licensed under the **GNU GENERAL PUBLIC LICENSE v3**.\n\n## 📬 Contact\n\nFor inquiries, reach out to me at [Suyash Pandey](mailto:suyash.2023ug1100@iiitranchi.ac.in).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecstaticfly%2Freferralhub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fecstaticfly%2Freferralhub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecstaticfly%2Freferralhub/lists"}