Workflow

Marketing automation — drip campaigns, delays, and multi-step journeys via BullMQ.

Run bun setup once from the monorepo root. Env files come from bun setup / bun env:setup.

Overview

Property	Value
Directory	`apps/backend/workflow`
Port	`8017`
Local URL	https://local.reloop.sh/api/workflow
Swagger UI	https://local.reloop.sh/api/workflow/openapi
Workbench	https://local.reloop.sh/api/workflow/jobs
Stack	ElysiaJS · PostgreSQL · Redis · NATS · BullMQ

Quick start

bun be:workflow:dev

Or bun backend:dev / bun dev.

Environment

apps/backend/workflow/.env — from bun setup / bun env:setup.

PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8017
BASE_URL="https://local.reloop.sh"
NATS_URL=nats://localhost:4222
NODE_ENV=development
# Optional basic-auth for Workbench (/api/workflow/jobs)
# WORKBENCH_USER=admin
# WORKBENCH_PASS=secret

Variable	Required	Default
`PG_URL`	YES	`postgresql://...`
`REDIS_URL`	YES	`redis://...`
`PORT`	YES	`8017`
`BASE_URL`	YES	`https://local.reloop.sh`
`NATS_URL`	YES	`nats://localhost:4222`
`WORKBENCH_USER`	No	empty (open in dev)
`WORKBENCH_PASS`	No	empty (open in dev)

Commands

Command	Description
`bun be:workflow:dev`	Start dev server with hot reloading
`bun run --filter=be-workflow build`	Compile production bundle
`bun run --filter=be-workflow start`	Run compiled production build
`bun run --filter=be-workflow check-types`	TypeScript type-check

Architecture

Layer	Detail
Triggers	NATS events (e.g. `contacts.created`) start automation journeys
Execution	BullMQ `workflow-queue` handles delayed steps and transitions
Integrations	Reads contacts/templates and triggers sends via mail
Monitoring	Workbench UI at `/api/workflow/jobs`

Setup

One-command local bootstrap

Port reference

Gateway routes and ports

Contacts

Trigger source for journeys

Mail

Sends from workflow steps

Overview

Quick start

Environment

Commands

Architecture

Next

Setup

Port reference

Contacts

Mail