Dev Server

The CLI provides a local development server that mimics the production Queuebase service.

Usage

npx queuebase dev [options]

Options

Flag	Description	Default
--port <port>	Server port	3847
--callback <url>	Callback URL for job execution	http://localhost:3000/api/queuebase

What it does

The dev server:

• Runs a local HTTP API on the specified port
• Stores jobs in a local SQLite database
• Polls for pending jobs and calls back to your app to execute them
• Handles retries, backoff, and scheduling locally

Typical setup

Run the dev server and your app in separate terminals:

# Terminal 1: Queuebase dev server
npx queuebase dev

# Terminal 2: Your app
npm run dev

The dev server accepts enqueue requests on http://localhost:3847 and calls back to your app’s handler at the configured callback URL (default: http://localhost:3000/api/queuebase).