slack-cloudflare-workers is an opinionated framework for building Slack applications designed specifically for Cloudflare Workers, leveraging their serverless environment. Inspired by Slack's popular Bolt framework but not strictly following its blueprint, it distinguishes itself with a strong TypeScript focus, built-in lazy listener capabilities (similar to bolt-python), and a commitment to zero additional runtime dependencies beyond its foundational `slack-edge` module. The current stable version is 1.3.9. This library caters to developers seeking highly performant, type-safe, and lightweight Slack integrations on the Cloudflare Workers platform, providing a streamlined experience compared to general-purpose Node.js frameworks. While release cadence isn't explicitly stated, the active development and frequent updates to the `slack-edge` ecosystem suggest a responsive maintenance schedule.
npm install slack-cloudflare-workersVerified import paths — ran on the pinned version, not inferred.
Sets up a basic Cloudflare Worker handling Slack 'hello' messages and '/echo' slash commands, demonstrating app initialization and event listeners.
Consult the `slack-cloudflare-workers` documentation (especially for event payloads and context objects) when porting Bolt.js code or encountering unexpected behavior.
Update to version `1.x.x` for the latest stable API. Always test updates thoroughly, especially if upgrading from pre-1.0 versions.
Define secrets (like `SLACK_SIGNING_SECRET`, `SLACK_BOT_TOKEN`) in `wrangler.toml` or using Cloudflare's dashboard, then access them via the `env` object passed to the Worker's `fetch` handler and during `App` initialization.
Ensure `SLACK_SIGNING_SECRET` is correctly set in your Cloudflare Worker's environment variables and exactly matches the value from your Slack app settings. Check for leading/trailing whitespace or accidental character changes.
Verify that `import { App } from 'slack-cloudflare-workers';` is correct and that `new App({ ... })` is called with valid parameters before attempting to call listener methods.Ensure `SLACK_BOT_TOKEN` is correctly provided to the `App` instance, either directly or via environment variables, and that it is a valid Slack bot token.