⏰ RailsCron — Distributed Cron Scheduler for Rails

First release 0.1.0 is empty gem. A scheduler-agnostic, multi-node-safe cron runner for Ruby and Rails.
Designed and maintained by Codevedas Inc.

This repository contains the RailsCron gem and its documentation site.

/repo-root
├── .github/              # CI workflows, issue templates
├── rails_cron/           # Gem source (lib/, bin/, gemspec)
├── docs/                 # Documentation site (Jekyll + Markdown)
└── README.md             # This file

rails_cron lets you register, schedule, and safely run recurring tasks across multiple Rails instances.
It ensures exactly-once dispatching per cron tick using distributed locks via Redis or PostgreSQL advisory locks.

It’s scheduler-agnostic — works with any background job system (ActiveJob, Sidekiq, Resque, etc.)
and provides a clean Ruby API, CLI, and Rails tasks.

Comprehensive guides are published at:

👉 https://rails-cron.codevedas.com

git clone https://github.com/CodevedasInc/rails-cron.git
cd rails-cron
bundle install

bin/rspec-unit

bin/rubocop

bin/Reek

You can load a local version of the gem in a test Rails app:

gem build rails_cron.gemspec
gem install ./rails_cron-0.1.0.gem

Or reference it directly in another app’s Gemfile:

gem "rails_cron", path: "../rails-cron/rails_cron"

The docs/ directory is a Jekyll site used for GitHub Pages.

cd docs
bundle install
bundle exec jekyll serve

Then open: 👉 http://localhost:4000

GitHub Actions workflows include:

• Contributing: see CONTRIBUTING.md
• Security policy: see SECURITY.md
• Code of Conduct: see CODE_OF_CONDUCT.md

Released under the MIT License © 2025 Codevedas Inc. — All rights reserved.