Skip to content

docs: updates environment variables page to be CLI-focused, not Deno-focused#498

Open
lukegalbraithrussell wants to merge 6 commits intomainfrom
docs-environment-variables
Open

docs: updates environment variables page to be CLI-focused, not Deno-focused#498
lukegalbraithrussell wants to merge 6 commits intomainfrom
docs-environment-variables

Conversation

@lukegalbraithrussell
Copy link
Copy Markdown
Contributor

@lukegalbraithrussell lukegalbraithrussell commented Apr 13, 2026

Changelog

(Add a note with features or fixes that change the user experience for release notes)

Summary

The content originally here is being added to the Deno Slack SDK hub as "Using env variables with the deno slack sdk"

Preview

Using environment variables with the Slack CLI
Using environment variables with the Deno Slack SDK

Requirements

@lukegalbraithrussell lukegalbraithrussell requested a review from a team as a code owner April 13, 2026 23:12
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 71.20%. Comparing base (dd3d92e) to head (76bd970).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #498      +/-   ##
==========================================
- Coverage   71.23%   71.20%   -0.03%     
==========================================
  Files         222      222              
  Lines       18664    18664              
==========================================
- Hits        13295    13290       -5     
- Misses       4189     4192       +3     
- Partials     1180     1182       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@zimeg zimeg changed the title Docs: updates environment variables page to be CLI-focused, not Deno-focused docs: updates environment variables page to be CLI-focused, not Deno-focused Apr 13, 2026
@zimeg zimeg added docs M-T: Documentation work only semver:patch Use on pull requests to describe the release version increment labels Apr 13, 2026
Copy link
Copy Markdown
Member

@zimeg zimeg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lukegalbraithrussell Incredible formats and fast writings. Thank you for polishing this page so much 🏆

I'm leaving a few comments of thoughts that could be useful but might be rambles:

  • Noting the ".env" file created for projects
  • Removing "internal" variables and related notes
  • Favor keeping this page CLI and Bolt focused

Please do take these suggestions as optional! And let me know if I can share more details toward this 🌲

There are three Slack CLI subcommands that can be used to modify environment variables:

### Storing local environment variables {#local-env-vars}
### `slack env set`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🐙 suggestion: Toward the end of this section it might be kind to note that these variables are saved to a .env file within the project?

🦕 ramble: Such a change has big preference to Bolt development, but I think the ROSI behavior might be better kept in adjacent pages.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

big agree but put it up top

Comment on lines +51 to +52
| `SLACK_APP_PATH` | Set when a custom start path is provided via `slack run` | Used to run from a non-root directory. | ✅ Supported | ✅ Supported |
| `SLACK_CLI_CUSTOM_FILE_PATH` | Set to the same value as `SLACK_APP_PATH` when a custom start path is provided via `slack run` | Used to run from a non-root directory. | ✅ Supported | ✅ Supported |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `SLACK_APP_PATH` | Set when a custom start path is provided via `slack run` | Used to run from a non-root directory. | ✅ Supported | ✅ Supported |
| `SLACK_CLI_CUSTOM_FILE_PATH` | Set to the same value as `SLACK_APP_PATH` when a custom start path is provided via `slack run` | Used to run from a non-root directory. | ✅ Supported | ✅ Supported |

🪝 suggestion: These might be most meaningful for "hook" developers, who might prefer to find this in adjacent pages:

🔗 https://docs.slack.dev/tools/slack-cli/reference/hooks/#start

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think these should be kept in case they're confused why it's not here

lukegalbraithrussell and others added 2 commits April 14, 2026 09:10
Co-authored-by: Eden Zimbelman <zim@o526.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs M-T: Documentation work only semver:patch Use on pull requests to describe the release version increment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants