Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/botpress/botpress/llms.txt

Use this file to discover all available pages before exploring further.

Development commands for local testing and iteration.

bp dev

Run project in development mode with hot reload:
bp dev
This command:
  1. Builds your project
  2. Starts local server
  3. Creates tunnel for webhooks
  4. Deploys to cloud in dev mode
  5. Watches for file changes
  6. Auto-reloads on changes

Options

—port

Specify server port:
bp dev --port 3000
Defaults:
  • Bots: 8075
  • Integrations: 8076

—tunnelUrl

Custom tunnel URL:
bp dev --tunnelUrl https://tunnel.example.com

—tunnelId

Specific tunnel ID:
bp dev --tunnelId my-tunnel-id

—noBuild

Skip initial build:
bp dev --noBuild

—noSecretCaching

Disable secret caching:
bp dev --noSecretCaching

bp serve

Serve project locally without cloud deployment:
bp serve
Options:
bp serve --port 3000

Development workflow

1

Start dev server

bp dev
2

Make changes

Edit your source files
3

Auto-reload

Server detects changes and reloads
4

Test

Test changes immediately

Environment variables

Dev mode sets:
BP_API_URL=<cloud-api-url>
BP_TOKEN=<your-token>
Integrations also get secret variables.