bullstudio

library1.5.0jsnpmunverified

BullStudio v1.5.0 is a lightweight, CLI-based queue monitoring dashboard for Bull and BullMQ. It provides a real-time web UI to inspect, retry, and manage jobs without writing any code. Differentiators include zero-config setup, minimal dependencies, and a clean, focused interface. Release cadence is periodic with no fixed schedule. It supports Node >=20 and uses Redis as backend.

devops

npm install bullstudio

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BULLSTUDIO

bullstudio

devopsjavascriptv1.5.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BullStudio

✓ import BullStudio from 'bullstudio'

✗ const BullStudio = require('bullstudio')

ESM-only module since Node >=20. CommonJS require is not supported.

BullStudio (type)

✓ import type { BullStudioOptions } from 'bullstudio'

TypeScript types are exported for configuration options.

launch

✓ import { launch } from 'bullstudio'

Main entry function to start the dashboard programmatically.

This example creates a BullStudio instance with two Bull queues, connects to Redis locally, and starts the dashboard on port 3001.

import BullStudio from 'bullstudio'; const studio = new BullStudio({ queues: [ { name: 'email', host: '127.0.0.1', port: 6379 }, { name: 'report', host: process.env.REDIS_HOST ?? '127.0.0.1', port: 6379 } ], port: 3001 }); await studio.start(); console.log('BullStudio running on http://localhost:3001');

Debug

Known issues

breakingBullStudio v1.5.0 drops support for Node <20. Previous versions (1.x) ran on Node 16+.

fix

Upgrade Node to version 20 or higher.

affects: >=1.5.0

gotchaRedis must be running locally or accessible via the provided host/port. The CLI defaults to 127.0.0.1:6379.

fix

Start Redis before launching BullStudio, or update the connection settings.

affects: <2.0

gotchaBullStudio does not support authentication for Redis connections in v1.5.0. Use password-protected Redis with caution.

fix

Consider an older version or patch the source to add auth support.

affects: =1.5.0

Errors

Common errors & fixes

TypeError: BullStudio is not a constructor

Using CommonJS require on ESM-only package.

fix

Use ES modules (import) or run with node --experimental-modules flag, but prefer ESM.

Error: Redis connection to 127.0.0.1:6379 failed - connect ECONNREFUSED

Redis server is not running or not accessible.

fix

Start Redis using 'redis-server' or update the connection host/port.

Error: listen EADDRINUSE :::3001

Port 3001 is already in use by another process.

fix

Specify a different port via the constructor option or kill the process on port 3001.

Upgrade

Version history

1.5.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

9 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/emirce/bullstudio ↗

packagebullstudio ↗

homepagehttps://github.com/emirce/bullstudio#readme ↗