Our future generation platform is in closed beta. During the beta, expect some rough edges, broken windows overlooking blue sky vistas, and regularly scheduled changes.

Already signed up? Great! You can ignore this.
Need to sign up? Apply to join the beta.

Creating a new app

Verify workspace authentication

The first step in creating a new app is to ensure that your CLI is authenticated into the workspace you want to develop in. You can do this with slack auth list:

$ slack auth list 

ACTIVE  myworkspace (Team ID: T123456789)
User ID: U123456789
Last update: 2022-03-24 18:20:47 -07:00

To change your active workspace authorization run slack login

Ensure that the workspace you want to build an app for has the ACTIVE label next to it. In the above example, myworkspace is ready to be used.

Scaffold a new app

With our CLI authenticated into the workspace we want to develop in, the next step is to scaffold an app with slack create:

$ slack create my-app

The above command will scaffold a new app named my-app in a directory with the same name.

If you don't pass an app name, slack will scaffold an app with a random alphanumeric name.

$ slack create my-app

Creating new Slack app at /Users/me/dev/my-app

⚙️  Created project directory
   Detected a Deno project

📦 Installed project dependencies

✨ my-app successfully created

🧭 Explore your project's README.md for documentation and code samples, and at any time run `slack help` to display a list of available commands

🧑‍🚀 Follow the steps below to try out your new project

1️⃣  Change into your project directory with: cd my-app

2️⃣  Develop locally and see changes in real-time with: slack run

3️⃣  When you're ready to deploy for production use: slack deploy

Once your app is finished being scaffolded, don't forget to cd into your app project's directory.

To keep building your new app, head to the next section: Configuring an app.