📦 SubDub: Subscription Tracker API

A production-ready Subscription Management System API with rate limiting, JWT authentication, email reminders, and workflow automation.

---

📋 Table of Contents

1. 🤖 Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start
5. 🕸️ Snippets
6. 🔗 Assets
7. 📞 Contacts

---

🤖 Introduction

SubDub is a Subscription Management System API designed to help users track, manage, and get notified about upcoming subscription renewals.

It comes with:

• JWT authentication for secure user sessions
• MongoDB & Mongoose models for subscriptions and users
• Arcjet middleware for bot detection and rate limiting
• Upstash Workflows to schedule email reminders before renewals
• Nodemailer templates for beautiful, responsive reminder emails

---

⚙️ Tech Stack

• Node.js – runtime environment
• Express.js – web framework
• MongoDB – NoSQL database
• Arcjet – security & rate-limiting middleware
• Upstash QStash – workflows for scheduling reminders
• Nodemailer – email delivery service

---

🔋 Features

→ Advanced Rate Limiting and Bot Protection: with Arcjet that helps you secure the whole app.

→ Database Modeling: Models and relationships using MongoDB & Mongoose.

→ JWT Authentication: User CRUD operations and subscription management.

→ Global Error Handling: Input validation and middleware integration.

→ Logging Mechanisms: For better debugging and monitoring.

→ Email Reminders: Automating smart email reminders with workflows using Upstash.

and many more, including code architecture and reusability

---

🤸 Quick Start

Prerequisites

• Git
• Node.js
• npm

Clone the Repository

git clone https://github.com/Itssanthoshhere/Subscription-Tracker-Api.git
cd Subscription-Tracker-Api

Install Dependencies

npm install

Setup Environment Variables

Create .env.development.local:

# PORT
PORT=5500
SERVER_URL="http://localhost:5500"

# ENVIRONMENT
NODE_ENV=development

# DATABASE
DB_URI=

# JWT AUTH
JWT_SECRET=
JWT_EXPIRES_IN="1d"

# ARCJET
ARCJET_KEY=
ARCJET_ENV="development"

# UPSTASH
QSTASH_URL=http://127.0.0.1:8080
QSTASH_TOKEN=

# NODEMAILER
EMAIL_PASSWORD=

Run the Project

npm run dev

API will be running at: 👉 http://localhost:5500

---

🕸️ Snippets

Sample Subscription JSON

{
  "name": "Netflix Premium",
  "price": 15.99,
  "currency": "USD",
  "frequency": "monthly",
  "category": "Entertainment",
  "startDate": "2025-01-20T00:00:00.000Z",
  "paymentMethod": "Credit Card"
}

---

🔗 Links

• Arcjet → https://arcjet.com
• Upstash QStash → https://upstash.com
• MongoDB Atlas → https://www.mongodb.com/atlas
• Nodemailer → https://nodemailer.com

---

🔗 Contacts

👤 Santhosh VS

• GitHub: Itssanthoshhere
• LinkedIn: Santhosh VS

---

⭐️ Show Your Support

If you liked this project, give it a ⭐ and share it with others!

---