diff --git a/docs/guides/installing-the-slack-cli-for-mac-and-linux.md b/docs/guides/installing-the-slack-cli-for-mac-and-linux.md index 5fb9c97f..adb2270f 100644 --- a/docs/guides/installing-the-slack-cli-for-mac-and-linux.md +++ b/docs/guides/installing-the-slack-cli-for-mac-and-linux.md @@ -86,6 +86,8 @@ Solution: Sudo actions within the scripts were removed so as not to create any s +Manual installation allows you to omit the Deno installation if you don't need it. Deno is needed if you are creating [workflow apps](https://docs.slack.dev/workflows). If you intend to solely use the CLI for Bolt apps, you do not need Deno. If you forgo the Deno installation, skip to step 3. + **1\. Download and install [Deno](https://deno.land).** Refer to [Install Deno](/deno-slack-sdk/guides/installing-deno) for more details. **2\. Verify that Deno is installed and in your path.** diff --git a/docs/guides/installing-the-slack-cli-for-windows.md b/docs/guides/installing-the-slack-cli-for-windows.md index a4b9c6c0..53dcac15 100644 --- a/docs/guides/installing-the-slack-cli-for-windows.md +++ b/docs/guides/installing-the-slack-cli-for-windows.md @@ -108,6 +108,8 @@ Solution: For the installer to work correctly, your PowerShell session's [langua +Manual installation allows you to omit the Deno installation if you don't need it. Deno is needed if you are creating [workflow apps](https://docs.slack.dev/workflows). If you intend to solely use the CLI for Bolt apps, you do not need Deno. If you forgo the Deno installation, skip to step 3. + **1\. Download and install [Deno](https://deno.land).** Refer to [Install Deno](/deno-slack-sdk/guides/installing-deno) for more details. **2\. Verify that Deno is installed and in your path.** diff --git a/docs/guides/using-slack-cli-with-bolt-frameworks.md b/docs/guides/using-slack-cli-with-bolt-frameworks.md index 779f279a..40d67765 100644 --- a/docs/guides/using-slack-cli-with-bolt-frameworks.md +++ b/docs/guides/using-slack-cli-with-bolt-frameworks.md @@ -46,4 +46,12 @@ To run your new app, use the `slack run` command with the experiment flag as fol slack run ``` -You'll be prompted to choose your team/workspace, and then your app should let you know that it's up and running. 🎉 \ No newline at end of file +You'll be prompted to choose your team/workspace, and then your app should let you know that it's up and running. 🎉 + +## App manifest + +The Slack app manifest is the configuration of the app. The `manifest.json` file included with selected templates and samples reflects the features and permissions of your app. When you create an app with the CLI, the corresponding app and matching manifest can be found on [app settings](https://api.slack.com/apps). + +For Bolt apps created through the CLI, by default, the manifest source set in the `config.json` file is `remote`. This means that the manifest in your [app settings](https://api.slack.com/apps) is the source of truth. To modify the manifest (add new features, scopes, etc.), do so in the app settings. If you change the `config.json` to reflect a `local` manifest source and modify the local `manifest.json` file, the CLI will ask for confirmation before overriding the settings upstream on reinstall (run). This prompt appears if the app manifest on app settings differs from a known state saved in `.slack/cache`. There is not currently a dedicated manifest update command. + +In contrast, Deno apps created with the CLI have the manifest source configuration of `local` because those apps are not managed in the [app settings page](https://api.slack.com/apps). \ No newline at end of file