Slack Bot#

Production#

The production app is managed here.
Changes to scopes should be updated in the OAuth section for all bots, and in the code.

Local Dev#

See PR that created the local dev setup here.

Your Tailscale funnel URL will be https://YOUR_NAME.heron-perch.ts.net. This URL is publicly accessible and will be used to tunnel to your local dev environment. It is only accessible while you run the service locally.

YOUR_NAME can be anything you want, but it should be unique to avoid conflicts with other developers.

1. Create your Slack App#

Go to Slack Apps and create a new app from a manifest of one of the existing bots.

Let's create a script to automate app creation.

2. Set backend environment variables#

In backend/.env.development.local set,

TS_HOSTNAME="YOUR_NAME"
# choose one of the existing dev Slack Bots or create your own
SLACK_CLIENT_ID="..."
SLACK_CLIENT_SECRET="..."
SLACK_SIGNING_SECRET="..."

and delete previous env var references.

3. Set frontend environment variables#

In frontend/app/.env.development.local set,

NEXT_PUBLIC_SLACK_APP="https://YOUR_NAME.heron-perch.ts.net/slack/install"
BACKEND_URL="https://YOUR_NAME.heron-perch.ts.net"

4. Install the app to your Slack workspace#

1. Navigate to frontend/app and follow the README to run the app in development mode.
2. Create a new Slack workspace for your app.