navajyoth-puthalath13/reviewflow

ReviewFlow connects Figma and Slack so design review comments do not stay hidden inside Figma. When someone writes a comment in a specific format, such as an issue number, a short description, and a status word like completed or in progress, this tool catches that comment through a Figma webhook and posts a formatted message into a Slack channel automatically. The project is a lightweight Node.js server built with Express, meant to be deployed on Railway. Setup involves cloning the repository, installing dependencies, and filling in a handful of environment variables: a Slack bot token, the target Slack channel, a Figma webhook secret, and a Figma personal access token tied to the file you want to watch. A small helper script can register the Figma webhook automatically once those variables are in place, instead of doing it by hand. On the Slack side, you create a Slack app, give it permission to post messages, install it to your workspace, and invite the bot into the channel where updates should appear. On the Figma side, the README recommends using a file level webhook rather than a team level one, since team webhooks usually require admin access that most individual users do not have. The README includes a detailed troubleshooting section covering common failures: wrong Slack tokens, missing permissions, stale Railway deployments, and Figma repeatedly retrying a webhook because the server did not respond correctly. It also notes that the actual comment parsing logic is small compared to the work of wiring up the deployment, authentication, and webhook permissions correctly. This is an experimental, open source side project rather than a polished product, and the author lists several possible future additions such as syncing with GitHub issues, supporting multiple Slack channels, and adding AI generated review summaries, none of which are built yet. It is released under the MIT license.