feat: showcase the app home in surfaces example

.github/workflows/test.yml

@@ -12,6 +12,7 @@ jobs:
       matrix:
         showcase:
           - "block-kit"
+          - "surfaces/app-home"
     steps:
       - name: Checkout code
         uses: actions/checkout@v5

README.md

@@ -5,3 +5,4 @@ This collections of examples highlights features of a Slack app in the language
 ## Available demonstration
 
 - **[Block Kit](./block-kit)**: The framework of visual components arranged to create app layouts.
+- **[Surfaces](./surfaces)**: Places where your app can express itself and communicate with users.

surfaces/README.md

@@ -0,0 +1,9 @@
+# Surfaces
+
+Places where your app can express itself and communicate with users.
+
+Read the [docs](https://docs.slack.dev/surfaces/) to learn concepts behind these constructions.
+
+## What's on display
+
+- **[App Home](https://docs.slack.dev/surfaces/app-home)**: A space shared between the user and app with tabbed views. [Implementation](./app-home).

surfaces/app-home/.gitignore

@@ -0,0 +1 @@
+node_modules

surfaces/app-home/.slack/.gitignore

@@ -0,0 +1,4 @@
+apps.json
+apps.dev.json
+cache/
+config.json

surfaces/app-home/.slack/hooks.json

@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "get-hooks": "npx -q --no-install -p @slack/cli-hooks slack-cli-get-hooks"
+  }
+}

surfaces/app-home/README.md

@@ -0,0 +1,13 @@
+# App Home
+
+A space shared between the user and app with tabbed views.
+
+Read the [docs](https://docs.slack.dev/surfaces/app-home) to learn concepts behind these constructions.
+
+## Running the app
+
+Start the app then go to the app's Home tab in Slack:
+
+```sh
+$ slack run
+```

surfaces/app-home/biome.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}

surfaces/app-home/manifest.json

@@ -0,0 +1,32 @@
+{
+  "display_information": {
+    "name": "Bolt JS Example - App Home"
+  },
+  "features": {
+    "app_home": {
+      "home_tab_enabled": true,
+      "messages_tab_enabled": true,
+      "messages_tab_read_only_enabled": false
+    },
+    "bot_user": {
+      "display_name": "Bolt JS Example - App Home",
+      "always_online": true
+    }
+  },
+  "oauth_config": {
+    "scopes": {
+      "bot": ["chat:write", "im:history"]
+    }
+  },
+  "settings": {
+    "event_subscriptions": {
+      "bot_events": ["app_home_opened", "message.im"]
+    },
+    "interactivity": {
+      "is_enabled": true
+    },
+    "org_deploy_enabled": true,
+    "socket_mode_enabled": true,
+    "token_rotation_enabled": false
+  }
+}