https://github.com/sunjay-dev/cronjob-scheduler

An Agenda.js-powered cron job scheduler to automate API/webhook calls. Built with Agenda.js, Express, and React.
https://github.com/sunjay-dev/cronjob-scheduler

agenda-js lucide-react passport-js redux-toolkit typescript

Last synced: 10 months ago
JSON representation

An Agenda.js-powered cron job scheduler to automate API/webhook calls. Built with Agenda.js, Express, and React.

• Host: GitHub
• URL: https://github.com/sunjay-dev/cronjob-scheduler
• Owner: sunjay-dev
• Created: 2025-07-08T06:43:00.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-08-05T16:09:33.000Z (10 months ago)
• Last Synced: 2025-08-05T18:11:35.390Z (10 months ago)
• Topics: agenda-js, lucide-react, passport-js, redux-toolkit, typescript
• Language: TypeScript
• Homepage: https://www.cronjon.site/
• Size: 1.57 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# CronJob-Scheduler



A simple yet powerful cron job scheduler to automate recurring API requests (GET/POST) using [Agenda.js](https://github.com/agenda/agenda). Schedule jobs, view logs, and control execution — all from a modern web dashboard.

---

## 🚀 Features

- 🕒 Schedule recurring jobs using cron expressions

- 📡 Supports GET, POST and many other requests options with custom headers/body

- 🧠 Built on **Agenda.js** for robust background processing

- 📊 View job execution logs and status (success/failure)

- ✨ Toggle jobs on/off without deleting them

- 💻 Clean React + Tailwind dashboard

- 🔐 JWT-based authentication

---

## 🛠️ Tech Stack

![MongoDB](https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=for-the-badge&logo=mongodb&logoColor=white) 

![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white) 

![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge&logo=react&logoColor=%2361DAFB) 

![TailwindCSS](https://img.shields.io/badge/Tailwind_CSS-06B6D4.svg?style=for-the-badge&logo=tailwindcss&logoColor=white)

![Chart.js](https://img.shields.io/badge/chart.js-F5788D.svg?style=for-the-badge&logo=chart.js&logoColor=white) 

![Lucide-React](https://img.shields.io/badge/Lucide--React-000000.svg?style=for-the-badge&logo=lucide&logoColor=white)

![Express.js](https://img.shields.io/badge/express.js-%23404d59.svg?style=for-the-badge&logo=express&logoColor=%2361DAFB)

![Redux-toolKit](https://img.shields.io/badge/redux_toolkit-%23593d88.svg?style=for-the-badge&logo=redux&logoColor=white)

![Agenda.js](https://img.shields.io/badge/Agenda.js-%23ef4444.svg?style=for-the-badge&logo=nodedotjs&logoColor=white)

![PNPM](https://img.shields.io/badge/pnpm-%234a4a4a.svg?style=for-the-badge&logo=pnpm&logoColor=f69220)

![Passport.js](https://img.shields.io/badge/Passport.js-000000.svg?style=for-the-badge&logo=passport&logoColor=00ff99)

![Resend](https://img.shields.io/badge/Resend-000000.svg?style=for-the-badge&logo=resend&logoColor=fff)

![Zod](https://img.shields.io/badge/Zod-7C3AED.svg?style=for-the-badge&logo=zod&logoColor=white)

---

## 📦 Installation

### 1. Clone the repository

```bash

git clone https://github.com/sunjay-dev/CronJob-Scheduler.git

cd CronJob-Scheduler

````

### 2. Setup Backend

```bash

cd server

pnpm install

cp .env.example .env

# Update .env with your MongoDB URI and JWT secret

pnpm run dev

```

### 3. Setup Frontend

```bash

cd ../client

pnpm install

pnpm run dev

```

---

## 🧪 Environment Variables

Example `.env` file for backend:

```env

PORT=5000

MONGO_URI=YOUR_MONGO_URI

MONGO_DB_COLLECTION=agendaJobs

JWT_SECRET=YOUR_JWT_SECRET

CLIENT_URL=http://localhost:5173

GOOGLE_CLIENT_ID=GOOGLE_CLIENT_ID

GOOGLE_CLIENT_SECRET=GOOGLE_CLIENT_SECRET

GOOGLE_CALLBACK_URL=http://localhost:3000/auth/google/callback

RESEND_EMAIL_API_KEY=RESEND_EMAIL_API_KEY

SENDEREMAIL=SENDEREMAIL

```

---

## 🖥️ Folder Structure

```

CronJob-Scheduler/

├── Backend/     # Server (Express + Agenda.js)

├── Frontend/    # Client (React + Tailwind)

├── README.md       

```

---

## 🧭 Roadmap

*  Create/Update/Delete jobs

*  Job toggle (enable/disable)

*  Execution logs viewer

*  Support for PUT/DELETE requests

*  User account settings 

*  Google login config 

*  Forget password 

* [ ] Email notifications on failure

* [ ] Retry on failure + backoff strategy

## 🤝 Contributing

Contributions, suggestions, and improvements are always welcome!