Introduction

Queuebase is a background job processing system. Jobs use a callback model: your app defines job handlers at a webhook endpoint, the Queuebase service stores and schedules jobs, then calls back to your app to execute them. This works identically in local dev (via the CLI) and in production.

How it works

1. Your app calls jobClient.myJob.enqueue({ ... })
2. The SDK POSTs the job to the Queuebase API (local CLI in dev, hosted API in production)
3. Queuebase stores the job in the database and schedules it
4. When it’s time to run, Queuebase POSTs back to your app’s webhook endpoint (e.g. /api/queuebase)
5. Your handler executes the job and returns the result

This callback model means your job code lives in your app, not in a separate worker process. Queuebase handles the scheduling, retries, and persistence.

Installation

Next.js

npm install @queuebase/nextjs zod

Node.js (Express, Fastify, etc.)

npm install @queuebase/node zod

Both packages re-export everything from @queuebase/core, so you only need one.

Next steps

• Quick start with Next.js
• Quick start with Node.js