vcron

stars status

vcron is a lightweight, self-hosted cron job scheduler for HTTP endpoints. Register your APIs, create scheduled jobs, and let vcron hit your endpoints on time — every time. Built in Rust with SQLite, designed for minimal resource usage.

This repository contains both the backend (Rust + Axum + SQLite) and the frontend (Next.js 16 + React 19 + Tailwind CSS v4).

# Backend
cargo build --release
./target/release/vcron
# Frontend
cd client
npm install
npm run dev

• Flexible scheduling — Standard 5-field cron expressions or interval:N syntax for sub-minute intervals (30s minimum)
• Multi-app support — Register multiple APIs as apps, each with its own base URL. Jobs define relative paths (e.g. /healthz)
• Built-in retries — Automatic exponential backoff with configurable retry count and timeout per job
• Run history — Full execution logs with HTTP status codes, response bodies, durations, and error messages
• Secure auth — Username + password with bcrypt hashing and JWT cookie sessions. Data scoped per user
• Pixel loader — Custom canvas-based loading animation on first page visit
• Real-time dashboard — Live stats, auto-refreshing job lists, relative timestamps that tick every second
• Borderless UI — Dark editorial design inspired by portfolio aesthetics, glow cards, accent bars, noise texture

User Browser → Frontend (Next.js) → Backend (Rust + SQLite)
 │ │
 │ /api/* proxied │ Scheduler ticks every 5s
 │ via rewrites │ Picks due jobs
 │ │ Spawns tokio tasks
 ↓ ↓
 Next.js renders HTTP requests hit
 landing + dashboard target URLs

1. Register your API — Create an app with a base URL (e.g. https://api.example.com)
2. Add jobs — Define paths like /healthz, pick a schedule (every 30s, cron expression), set HTTP method and headers
3. Relax — vcron's scheduler ticks every 5 seconds, picks up due jobs, executes HTTP requests with retry support, and logs every result

The scheduler uses tokio::time::interval with a 5-second tick (configurable). Due jobs are fetched via a SQL query that joins jobs + apps for the full URL. Each execution spawns an independent tokio task that:

• Creates a job_runs record with status='running'
• Executes the HTTP request (with configurable timeout + exponential backoff retries)
• Updates the run record with status, status code, response body (truncated to 64KB), duration, and error
• Calculates the next run time and updates the job

Backend (.env):

Frontend (.env.local):

vcron/
├── src/
│ ├── api/
│ │ ├── apps.rs # App CRUD routes
│ │ ├── auth.rs # Register, login, JWT middleware
│ │ ├── health.rs # Health check endpoint
│ │ ├── jobs.rs # Job CRUD + runs + stats routes
│ │ └── mod.rs # Router assembly
│ ├── db/
│ │ ├── models.rs # Data models (User, App, Job, JobRun, etc.)
│ │ ├── queries.rs # All SQL queries (scoped by user_id)
│ │ └── mod.rs
│ ├── scheduler/
│ │ └── engine.rs # Background scheduler loop
│ ├── executor/
│ │ └── http.rs # HTTP job executor with retries
│ ├── config.rs # Environment config
│ ├── error.rs # Error types → HTTP status mapping
│ ├── main.rs # Application entry point
│ └── util.rs # Cron validation + next run calculation
├── migrations/
│ ├── 001_create_users_table.sql
│ ├── 002_create_apps_table.sql
│ ├── 003_create_jobs_table.sql
│ ├── 004_create_job_runs_table.sql
│ └── 005_add_updated_at_triggers.sql
├── client/ # Next.js frontend
│ ├── src/
│ │ ├── app/
│ │ │ ├── (root)/ # Public routes (landing, auth)
│ │ │ └── (secure)/ # Authenticated routes (dashboard, logs, apps, jobs)
│ │ ├── components/ # Nav, PixelLoader, Marquee, ConfirmModal, JobForm, etc.
│ │ ├── hooks/ # useRevealer
│ │ └── lib/ # api.ts, types.ts, utils.ts, useTick, useInitialLoader
│ ├── public/ # Logos, icons
│ └── next.config.ts # API rewrites to BACKEND_URL
├── Cargo.toml
├── .env.example
└── README.md

Issues and pull requests welcome.

Build & typecheck:

# Backend
cargo build
cargo build --release # optimized binary
# Frontend
cd client && npm run build
cd client && npx tsc --noEmit

MIT — see LICENSE for details.