Skip to content

rahulvijay81/recurb

πŸ”„ Recurb

Self-hosted subscription tracking that respects your privacy

Quick Start β€’ Features β€’ Tech Stack β€’ Documentation β€’ Community

GitHub stars License GitHub issues

GitHub Sponsors Buy Me A Coffee


πŸ“Έ Screenshots

Add screenshots here showcasing the dashboard, analytics, and key features


✨ Features

  • πŸ”’ Privacy-First - Self-hosted solution, your data stays on your server
  • πŸ—„οΈ Multi-Database Support - Choose between SQLite, PostgreSQL, or MySQL
  • πŸ“Š Advanced Analytics - Track spending trends, forecasts, and insights
  • 🎨 Beautiful UI - Modern design with dark mode support
  • πŸ‘₯ Team Collaboration - Role-based access control and audit logs
  • πŸ”” Smart Notifications - Renewal alerts and payment reminders
  • πŸ’° Cost Optimization - Duplicate detection and spending analysis
  • πŸ“ˆ Financial Forecasting - Predict future expenses and budget accordingly
  • πŸ”„ Bulk Operations - Import/export subscriptions with ease
  • 🌍 Multi-Currency - Support for multiple currencies and conversion
  • πŸ“± Responsive Design - Works seamlessly on desktop, tablet, and mobile
  • πŸ”§ Developer-Friendly - Easy to extend and customize

πŸš€ Quick Start

Get Recurb up and running in 3 simple steps:

# 1. Clone the repository
git clone https://github.com/rahulvijay81/recurb.git
cd recurb

# 2. Install dependencies
npm install

# 3. Set up environment and start
cp .env.example .env.local
npm run migrate
npm run dev

Visit http://localhost:3000 and complete the setup wizard!

🐳 Docker Quick Start

docker-compose up -d

πŸ“‹ Prerequisites

  • Node.js 18+
  • npm or yarn
  • One of: SQLite (default), PostgreSQL, or MySQL

πŸ› οΈ Tech Stack

Next.js TypeScript React Tailwind CSS Zustand SQLite PostgreSQL MySQL

Frontend:

  • Next.js 15 (App Router)
  • React 19
  • TypeScript
  • Tailwind CSS 4
  • Shadcn/ui Components
  • Zustand (State Management)
  • Chart.js (Analytics)

Backend:

  • Next.js API Routes
  • JWT Authentication
  • Multi-database support (SQLite/PostgreSQL/MySQL)
  • Node-cron (Scheduled tasks)

Security:

  • bcryptjs (Password hashing)
  • JWT tokens
  • Role-based access control
  • Rate limiting
  • CSRF protection

πŸ“š Documentation


🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ’– Support the Project

If Recurb helps you manage your subscriptions, consider supporting its development:

Sponsor Tiers

  • $5/mo - Supporter badge
  • $10/mo - Name in README
  • $25/mo - Priority support
  • $50/mo - Feature request priority
  • $100/mo - 1-on-1 consultation (1hr/mo)
  • $500/mo - Enterprise support

🌟 Community

Join our community to get help, share ideas, and connect with other users:


πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

Built with ❀️ using amazing open-source projects:


Made with ❀️ by Rahul Vijay

⭐ Star us on GitHub β€” it motivates us a lot!

About

Recurb is a modern, scalable web application built with Next.js, TypeScript, and Tailwind CSS, focused on performance, clean architecture, and real-world production readiness.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors