# Tack

> A live, multiplayer whiteboard full of your real issues and pull requests. Plan together, and what you decide goes back to GitHub. Free, open source and self-hosted.

Tack is self-hosted: each instance is one Cloudflare Worker on its owner's Cloudflare account, with a GitHub App they own. There's no hosted Tack. Every page below is Markdown; its HTML is at the same address without `.md`. To set up an instance from a terminal, start with the first link.

## Set up your own

- [Set up Tack with a coding agent](https://tack.social/setup.md): step-by-step instructions for a coding agent in the user's terminal: prerequisites, forking with `gh`, configuring and deploying with the `cf` CLI, and the browser steps only the user can do

## Start here

- [What Tack is](https://tack.social/start/introduction.md): A GitHub-native whiteboard for open source planning, and the rules it keeps.
- [A two-minute tour](https://tack.social/start/tour.md): Make a board, bring in issues, sketch, stage some changes and push them.

## Using boards

- [Boards and sharing](https://tack.social/boards/boards-and-sharing.md): The home page, making and renaming boards, roles, visibility and archiving.
- [Embeds and link previews](https://tack.social/boards/embeds.md): Live images of a public board, or part of it, for READMEs and docs, and how its links unfurl.
- [Cards](https://tack.social/boards/cards.md): Live GitHub issues, pull requests and discussions on the board, and what each part of a card means.
- [Link cards](https://tack.social/boards/link-cards.md): Any web page on the board as a card with its preview, read once and kept on the board for everyone.
- [Stickies and text](https://tack.social/boards/stickies-and-text.md): Stickies for ideas, text for headings and notes.
- [Images](https://tack.social/boards/images.md): Screenshots, photos and pictures on a board, and who can see them.
- [Stacks](https://tack.social/boards/stacks.md): Drop a sticky or a card onto another to stack them, named from what's in them. Group a whole selection into themes at once.
- [Sections](https://tack.social/boards/sections.md): Frames that hold cards and stickies, and what they can become.
- [Connectors](https://tack.social/boards/connectors.md): Arrows between shapes, with labels and styles, and what they can become.
- [Decisions](https://tack.social/boards/decisions.md): Propose a decision, vote, decide, and write it back to GitHub.
- [AI](https://tack.social/boards/ai.md): Ask for a widget in words, summarise what's selected, and draft a decision from it.
- [Working on the canvas](https://tack.social/boards/canvas.md): Selecting, arranging, copying, undoing, zooming, and seeing who's here.
- [History](https://tack.social/boards/history.md): Scrub back through a board, see who changed what, and bring back what was removed.
- [Export, import and backups](https://tack.social/boards/export.md): Save a board or a selection as a PNG or SVG, export a board as JSON and import it into a new board, and back boards up to a branch on GitHub.
- [Phones and tablets](https://tack.social/boards/phones-and-tablets.md): Looking around a board, voting, commenting and adding stickies on a phone, and editing with a finger or a pencil on a tablet.
- [Accessibility](https://tack.social/boards/accessibility.md): Using a board from the keyboard and with a screen reader, contrast in both themes, and reduced motion.
- [Keyboard shortcuts](https://tack.social/boards/shortcuts.md): Every keyboard shortcut on a board, for macOS, Windows and Linux.

## Writing back to GitHub

- [How writing back works](https://tack.social/writing-back/overview.md): Staging changes, the changes panel, and why nothing reaches GitHub by accident.
- [Built-in actions](https://tack.social/writing-back/actions.md): Every action that stages changes for GitHub, what it needs selected, and what it writes.
- [Pushing](https://tack.social/writing-back/pushing.md): The push sheet, pushing as yourself or as the bot, confirmation, retries and the history.
- [Decision records](https://tack.social/writing-back/decision-records.md): Writing a decision back as an ADR pull request or a Discussion post.
- [Backlinks](https://tack.social/writing-back/backlinks.md): Comment on issues with a link back to the board, and optionally a snapshot of it.

## Widgets

- [Overview](https://tack.social/widgets/overview.md): Live searches and views on the board, whose permissions they run with, and when they refresh.
- [List](https://tack.social/widgets/list.md): Any GitHub search, kept live. Drag rows out as cards, or drop cards in to make them match.
- [Timeline](https://tack.social/widgets/timeline.md): What was opened, closed, merged or updated between two dates, along a line.
- [Release draft](https://tack.social/widgets/release-draft.md): What's merged since the last release, sorted into release notes to copy.
- [Dependency map](https://tack.social/widgets/dependency-map.md): What blocks what, for a search or a section's cards, with the critical path and cycles.
- [Review queue](https://tack.social/widgets/review-queue.md): Pull requests waiting for review, oldest first, with their age, size, CI and reviews.
- [Milestone](https://tack.social/widgets/milestone.md): A milestone's progress, burn-up, pace and due date, and the open items most at risk.
- [Stale finder](https://tack.social/widgets/stale-finder.md): Items with no activity for a while, grouped by age, with quick ways to tidy them up.
- [Custom widgets](https://tack.social/widgets/custom.md): Your own JavaScript on the board, in a sandbox, drawing the board's data through a small read-only API.
- [Search syntax](https://tack.social/widgets/search-syntax.md): What searches widgets, inboxes and rules understand.

## Automation

- [Inbox frames](https://tack.social/automation/inboxes.md): A section that collects new matches for a search, for people to sort.
- [Rules](https://tack.social/automation/rules.md): Automation that places cards on the board when something happens on GitHub.
- [Comment commands](https://tack.social/automation/comment-commands.md): Put an issue or pull request on a board from a comment on GitHub.
- [Where cards come from](https://tack.social/automation/provenance.md): How cards remember how they arrived, and what happens when they stop matching.

## Facilitation

- [Running a session](https://tack.social/facilitation/running-a-session.md): The shared timer, spotlight and follow, stamps, emotes and high-fives.
- [Silent mode](https://tack.social/facilitation/silent-mode.md): Everyone writes on their own in a section; stickies stay face down until they're revealed.
- [Dot voting](https://tack.social/facilitation/dot-voting.md): Dot votes on a section or the whole board, live or open for days, counting 👍 on GitHub.
- [Comments](https://tack.social/facilitation/comments.md): Threads on anything on the board, with mentions, resolving and notifications.
- [Since you were here](https://tack.social/facilitation/since-you-were-here.md): What changed on the board, on GitHub and in comments while you were away.
- [Action items](https://tack.social/facilitation/action-items.md): Who'll do what by when, with a status that follows its GitHub issue, carried into the next session.
- [Weekly digests](https://tack.social/facilitation/weekly-digests.md): Once a week, what happened on a board, posted as a GitHub Discussion and emailed to the people who ask for it.

## Templates

- [Templates](https://tack.social/templates.md): Start a board from a template for the session you're running, and save any board as one.

## Self-hosting

- [Deploy Tack](https://tack.social/self-hosting/deploy.md): Run your own Tack on Cloudflare, with a GitHub App you own, from the Deploy to Cloudflare button or your own machine.
- [Set up the GitHub App](https://tack.social/self-hosting/github-app.md): Create the instance's GitHub App from /setup, what it asks for and why, and installing it.
- [Who can use it](https://tack.social/self-hosting/access.md): The instance's access list of admins, people and organisations, and the invite-only page.
- [Configuration](https://tack.social/self-hosting/configuration.md): Everything you can configure on an instance, where it lives, and what changing it does.
- [Other forges](https://tack.social/self-hosting/forges.md): Cards from GitLab, Codeberg and other Forgejo instances, and Tangled; their webhooks, tokens and writes, and how to set them up.
- [Repositories, live and not](https://tack.social/self-hosting/repositories.md): What changes when the GitHub App is installed on a repository, and how cards stay fresh.
- [Email](https://tack.social/self-hosting/email.md): Letting an instance send weekly digests by email, through Cloudflare Email Service.
- [Upgrading](https://tack.social/self-hosting/upgrades.md): Taking new versions of Tack, how boards and storage are migrated, rolling back, and what to do when Tack needs new GitHub permissions.
- [Observability](https://tack.social/self-hosting/observability.md): Finding Tack's logs, the events it logs, and browser error reports.
- [Costs and limits](https://tack.social/self-hosting/costs.md): What Tack uses on Cloudflare and GitHub, and what drives usage.
- [Local development](https://tack.social/self-hosting/local-development.md): Running Tack on your machine, with fake sign-in, the playground and test webhooks.

## Help

- [FAQ](https://tack.social/help/faq.md): Common questions about Tack.
- [Troubleshooting](https://tack.social/help/troubleshooting.md): What Tack's errors mean, and what to do about them.

## Optional

- [Complete documentation](https://tack.social/llms-full.txt): every page above, in one file
- [Try Tack](https://tack.social/try/): a board in the browser, with pretend people and a pretend GitHub, nothing to install
- [Source code](https://github.com/ascorbic/tack): the repository, with the Deploy to Cloudflare button