wasp-jobs

Orchestrate asynchronous background jobs in Wasp applications using PgBoss and PostgreSQL.

2|1|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/ToonVos/empty-opensaas --skill wasp-jobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wasp-jobs
Source: https://github.com/ToonVos/empty-opensaas/tree/main/.claude/skills/wasp-jobs
Command: npx skills add https://github.com/ToonVos/empty-opensaas --skill wasp-jobs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables the implementation of asynchronous background jobs and scheduled tasks in Wasp applications, offloading long-running operations from the main request cycle. It ensures application responsiveness and reliability for tasks like email sending, data processing, and recurring reports.

Core Features & Use Cases

  • PgBoss Integration: Leverages PgBoss for robust job queuing, scheduling (cron), and retry mechanisms, requiring PostgreSQL.
  • Asynchronous Task Execution: Guides on defining and implementing job functions that run independently, preventing UI freezes and timeouts.
  • Programmatic & Scheduled Triggers: Explains how to trigger jobs from Wasp actions or schedule them using cron expressions for recurring tasks.
  • Use Case: Set up a Wasp job called emailSender that sends a welcome email to new users. This Skill will guide you to define the job, implement its function, and trigger it from your signup action, ensuring emails are sent reliably in the background.

Quick Start

Set up a Wasp job called emailSender that sends a welcome email to new users. Schedule it to run immediately after a user signs up.

Frequently Asked Questions about wasp-jobs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run background jobs asynchronously in a Wasp application?

Background jobs in Wasp run asynchronously using PgBoss, a PostgreSQL-backed job queue. Define a job in your Wasp file, implement its handler function, and trigger it from actions or scheduled cron expressions. Jobs execute independently without blocking the main request cycle, keeping your app responsive.

Can I send emails asynchronously without freezing the user interface?

Yes. Queue email tasks as background jobs using PgBoss. Trigger the job immediately after signup or other events, and PgBoss handles delivery in the background. This prevents UI timeouts and ensures reliable delivery even if the initial request fails.

What database does Wasp background jobs require?

PgBoss, the job executor for Wasp background jobs, requires PostgreSQL as its backend. All job state, queuing, retry logic, and scheduling data is stored in PostgreSQL, so you must have a PostgreSQL database configured for your Wasp application.

How do I schedule recurring tasks or cron jobs in Wasp?

Define scheduled tasks in your Wasp job configuration using cron expressions. PgBoss interprets the cron syntax and triggers your job function at the specified intervals. You can also trigger jobs programmatically from actions with custom delay and retry controls.

What happens if a background job fails in Wasp?

PgBoss automatically retries failed jobs according to your configured retry policy. You can set retry counts, backoff delays, and expiration times. Failed jobs are tracked in PostgreSQL, allowing you to monitor, debug, and manually retry if needed.

Can I process large datasets or long-running operations without timing out?

Yes. Long-running operations like data processing or report generation run as background jobs outside the request cycle. PgBoss queues and executes them asynchronously, eliminating timeout constraints while keeping your application responsive to user requests.