Docs: V5 migration#2949
Open
lukegalbraithrussell wants to merge 3 commits into
Open
Conversation
|
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## v5 #2949 +/- ##
==========================================
- Coverage 94.38% 94.29% -0.10%
==========================================
Files 44 43 -1
Lines 7857 7323 -534
Branches 699 677 -22
==========================================
- Hits 7416 6905 -511
+ Misses 435 410 -25
- Partials 6 8 +2 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
haleychaas
reviewed
Jun 8, 2026
|
|
||
| _Minimum Node.js version: 20_ | ||
|
|
||
| Bolt for JS v5 follows the Node Slack SDK's shift from axios to the native [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). It also removes the deprecated Workflow Steps feature (retired by Slack in September 2024) and raises the minimum Node.js version to 20. |
Contributor
There was a problem hiding this comment.
Suggested change
| Bolt for JS v5 follows the Node Slack SDK's shift from axios to the native [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). It also removes the deprecated Workflow Steps feature (retired by Slack in September 2024) and raises the minimum Node.js version to 20. | |
| Bolt for JS v5 follows the Node Slack SDK's shift from axios to the native [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). It also removes the deprecated Workflow Steps from Apps feature (retired by Slack in September 2024) and raises the minimum Node.js version to 20. |
haleychaas
approved these changes
Jun 8, 2026
WilliamBergamin
approved these changes
Jun 8, 2026
Comment on lines
+51
to
+79
| ##### Option A: programmatically call once at startup {#programmatically-call-startup} | ||
|
|
||
| ```typescript | ||
| import http from 'node:http'; | ||
| import { App } from '@slack/bolt'; | ||
|
|
||
| http.setGlobalProxyFromEnv(); | ||
|
|
||
| const app = new App({ | ||
| token: process.env.SLACK_BOT_TOKEN, | ||
| signingSecret: process.env.SLACK_SIGNING_SECRET, | ||
| }); | ||
| ``` | ||
|
|
||
| ##### Option B: use an environment variable {#use-an-environment-variable} | ||
|
|
||
| ```bash | ||
| NODE_USE_ENV_PROXY=1 HTTPS_PROXY=http://corporate.proxy:8080 node app.js | ||
| ``` | ||
|
|
||
| ```typescript | ||
| import { App } from '@slack/bolt'; | ||
|
|
||
| // No proxy configuration needed — globalThis.fetch respects the environment | ||
| const app = new App({ | ||
| token: process.env.SLACK_BOT_TOKEN, | ||
| signingSecret: process.env.SLACK_SIGNING_SECRET, | ||
| }); | ||
| ``` |
|
|
||
| --- | ||
|
|
||
| ### We've removed Workflow Steps from Apps {#removed-workflow-steps} |
| * The `oauth` package has been updated to v4. | ||
| * The `types` package has been updated to v3. | ||
|
|
||
| Three packages have more substantial breaking changes: |
Contributor
There was a problem hiding this comment.
Only two are mentioned below, is this intentional?
But there are 3 packages with more substantial changes socket-more, web-api and webhook
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Docs for the migration to v5
Requirements