Guides | CronFlow Docs

Reliable background jobs, simplified.

Featured Guide

Architecting Idempotent Jobs for Financial Reconciliation

When processing Stripe webhooks and ledger entries, duplicate executions can corrupt your accounting pipeline. Learn how to implement idempotency keys, leverage CronFlow's `--skip-if-exists` flag, and structure your worker queues to guarantee exactly-once processing even during network partitions.

This walkthrough covers the complete lifecycle of a payment reconciliation job, from initial webhook ingestion to final database commit. You'll see how to use Redis-backed job locks, handle partial failures with retry backoff, and validate checksums against your core ledger. Includes production-ready TypeScript examples and database migration scripts for PostgreSQL 15+.

Read Featured Guide

Advanced Usage Patterns

Handling Timezone Changes & DST Transitions

Cron expressions evaluated in UTC drift when your application shifts to local timezones. Configure `TZ-aware` scheduling, implement daylight saving time fallbacks, and use CronFlow's `--adjust-clocks` directive to prevent double-executions during March/October transitions. Includes timezone database sync strategies for multi-region deployments.

View Guide

Scaling Worker Pools During Peak Traffic

When QPS spikes past 12,000 during Black Friday events, static worker pools bottleneck. Learn how to integrate CronFlow with Kubernetes HPA metrics, configure dynamic concurrency limits, and implement graceful queue draining. Covers auto-scaling thresholds, memory leak prevention in long-running Node.js workers, and connection pool management for MySQL 8.

View Guide

Circuit Breakers & Dead Letter Queues

Protect your infrastructure from cascading failures when third-party APIs degrade. Implement exponential backoff policies, route failed jobs to S3-backed dead letter queues, and set up automated alerting via PagerDuty. Includes configuration templates for handling rate limits from Twilio, SendGrid, and AWS SES.

View Guide