What is Push To Display?

Push To Display lets you send text and styled content to physical display boards — phones, tablets, or any screen running the app — in real time. You send a message, and it shows up on every device connected to that board instantly.

It's built for teams that want a simple way to push live information to shared screens: deploy status, queue counts, build results, alerts, or anything you'd otherwise check in a terminal or dashboard.

How it works

The flow is straightforward:

1. You send an update using whichever channel fits your workflow — an HTTP request, a CLI command, an AI agent tool call, or a GitHub Actions step.
2. The update reaches a board — a named destination you create in the app.
3. Every device connected to that board receives and displays the content in real time.

That's it. There's one public API endpoint. The rest is just choosing how you want to call it.

Four ways to send updates

All four channels send to the same API under the hood. Pick the one that matches how you work — you can always use more than one.

Key concepts

A few terms you'll see throughout the docs:

• Board — A named destination for updates. You create boards in the mobile app or via the CLI. Every board has an ID you use when sending updates.
• Layout — How panels are arranged on screen. Choose from Full Screen, Stacked, Side by Side, or 2×2 Grid.
• Panel — An independent area within a layout. Each panel can be updated separately, so you can show different information in each one.
• Block — A unit of text content with optional styling (size, weight, color, background). Each update contains one or more blocks.

You can learn more about these in the Concepts section.

Next steps

Ready to try it? Head to the Quickstart — you'll have content on a screen in about five minutes.