Introduction

Welcome to Fabric! 👋

Fabric lets your team create, collaborate on, and close GitHub Issues - all without leaving Slack.

We designed Fabric to be a tool for how your team actually works.

Create a GitHub issue quickly from a template and comment in the Issue Room.

What is Fabric?

Fabric is a tool for the whole issue lifecycle:

  • Create your Issue in Slack using a slash command (/issue), by reacting with the 🆕 emoji on an message, or clicking Create an issue on the corner of a message.

  • Choose a Template to save time in creating and routing your issue.

  • Open an Issue Room to collaborate on an issue in real-time, or start a thread.

  • Receive notifications in your Issue Room as the engineer works on a Pull Request.

  • When the Pull Request is merged, your Issue Room gets automatically archived.

Fabric keeps your team organized

The first Slack apps were notification-based. They sent events and information to your Slack workspace, often with a link to go see more details.

Slack apps then became action-based. The notifications were great, but users wanted to take actions on notifications without switching context.

The next set of Slack apps that are emerging are channel-based. When you're piping a lot of information into Slack and taking lots of actions, organization becomes important. You need to be able to quickly find what you want to update.

With channel-based Slack apps, everything has its place. Your team has a dedicated channel for each project, where they can chat and take contextual actions.

Sidebar sections + Slack's alphabetical ordering work great for organizing channels.

Some other channel-based apps include Troops.ai, Momentum.io, Intercom, and Google Calendar's Slack App.

How does Fabric work?

The main elements that you'll use to organize your issue tracking within Slack are Templates, Issue Feeds, and Issue Rooms.

  • Templates are used to apply defaults to issues and route issues to the right Issue Feed.

  • Issue Feeds are a stream of editable issues of a certain type, etc. #feed-bugs.

  • Issue Rooms are ephemeral Slack channels that let you collaborate on issues.

The best way to get started is with all five of our Recommended Templates: 🐞 Bug Report, 🚨 Incident, ⬆️ Feature Improvement, 💡 Feature Request, and 🏗 Technical Debt.

This will create (with your permission), five Slack channels: #feed--bug-reports, #feed--incidents, #feed--feature-improvements, #feed--feature-requests, and #feed--technical-debt.

Whenever an issue is created with the corresponding Template in any channel, it will get routed into the proper Issue Feed.

The Issue Feeds that Fabric will create (with your permission!).

For new issues, you can tell Fabric to automatically open an Issue Room. You can do this at the Team-level Settings (which we recommend- you can always toggle it off), or at the Template-level.

When Fabric opens Issue Rooms, it applies the prefix linked to that Template, ex. "#bug-".

Nervous about creating a lot of channels?

Channels scale really well in Slack.

With Slack channels, unless you've joined, you won't get notified about updates on a channel, and it won't show up in your sidebar. You can also mute any channel that you are a member of.

Channel search works pretty well, so you'll find yourself going to Slack to find your issue quickly.

Slack's sidebar sections (see 🔀 my issue feeds and ☀️ my issues for today) are a great way to further group and organize channels on a personal level.