Skip to content

docs: add quick start guide using the slack cli and terminal #1317

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

technically-tracy
Copy link
Contributor

@technically-tracy technically-tracy commented Jun 12, 2025

Summary

Docs: guide quick start app creation using the slack CLI following the Bolt for JS structure authored by @zimeg.

Testing

Category

  • slack_bolt.App and/or its core components
  • slack_bolt.async_app.AsyncApp and/or its core components
  • Adapters in slack_bolt.adapter
  • Document pages under /docs
  • Others

Requirements

Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you are agreeing to those rules.

  • I've read and understood the Contributing Guidelines and have done my best effort to follow them.
  • I've read and agree to the Code of Conduct.
  • I've run ./scripts/install_all_and_run_tests.sh after making the changes.

@technically-tracy technically-tracy requested a review from zimeg June 12, 2025 13:27
Copy link

codecov bot commented Jun 12, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.96%. Comparing base (7f9ae9c) to head (8101e8b).

✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1317   +/-   ##
=======================================
  Coverage   90.96%   90.96%           
=======================================
  Files         222      222           
  Lines        7501     7501           
=======================================
  Hits         6823     6823           
  Misses        678      678           

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

@zimeg zimeg added the docs Improvements or additions to documentation label Jun 13, 2025
Copy link
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.

@technically-tracy Wow! Thanks so much for putting this together so fast 🤖 ✨

I left a few comments on changes we'll need to make on the linked sample app and also some sample code we might want to include here!

These paths otherwise read well and some comments have thoughts on separating requirements more, but right now this makes most sense with the current capabilities released in the CLI ⚡

The comments on incoming CLI changes IMO don't have to block this from releasing either if we're alright with fast follows as well! 🚢 💨

Copy link
Contributor

@haleychaas haleychaas left a comment

Choose a reason for hiding this comment

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

Just some small nits

zimeg
zimeg previously requested changes Jun 25, 2025
Copy link
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.

@technically-tracy The quickstart is quite fast for starting in both setups though perhaps I've created too many apps... 📚

I requested a few changes around commands when setting the app up and exact outputs that might help avoid confusions later.

I'm not sure that automatic virtual environments have landed for the CLI at this time and might need to be documented, but we should revisit this later once that's stable ⛰️ ✨

@zimeg
Copy link
Member

zimeg commented Jun 25, 2025

👀 I'm noticing tests are failing for some reason also, but perhaps unrelated! Going to investigate this soon 🫡

@technically-tracy technically-tracy dismissed zimeg’s stale review June 26, 2025 12:31

These updates have been made!

@technically-tracy technically-tracy requested a review from zimeg June 26, 2025 12:31
@mwbrooks mwbrooks changed the title Docs: guide quick start app creation using the slack cli. docs: add quick start guide using the slack cli and terminal Jun 26, 2025
Copy link
Member

@mwbrooks mwbrooks left a comment

Choose a reason for hiding this comment

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

✅ Amazing work @technically-tracy!

🧪 I've read through the entire Quickstart Guide and manually followed the Slack CLI and Terminal steps. Both paths work well.

👏🏻 I was hoping to give you some feedback, but I have nothing for you. Everything looks excellent from my side!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy