> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardeck.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide: Connecting a POS to a Kitchen Display

> Send orders from your POS app to a kitchen display app so the kitchen sees new tickets in real time and can mark items as ready

This guide connects a Point of Sale app to a kitchen display app. When a cashier rings up an order, it appears on the kitchen display as a new ticket. When the kitchen marks an item as ready, the POS shows it's ready for pickup.

## How It Works

The two apps talk to each other through cross-app API calls:

* **POS → Kitchen**: "New order with these items"
* **Kitchen → POS**: "Order #47 is ready for pickup"

Each app has its own data, its own UI, and its own purpose. The POS handles customers and payments. The kitchen display handles prep queues and timing.

## Prerequisites

* A POS app and a kitchen display app, both built on Stardeck
* Both apps should have a running sandbox

## Step 1: Set Up the Kitchen Display to Receive Orders

Open the kitchen display app's project chat and ask:

```
Set up an API so the POS app can send new orders to the kitchen
```

The agent will create endpoints for receiving orders and managing ticket status.

Test it from the same chat:

```
Test the order endpoint — send a sample order with a few items
and make sure it shows up as a ticket
```

## Step 2: Set Up the POS to Receive Updates

Open the POS app's project chat and ask:

```
Set up an API so the kitchen display can tell us when an order
is ready for pickup
```

Test it:

```
Test the ready notification — mark a sample order as ready and
check that the status updates
```

## Step 3: Grant Cross-App Access

Both apps need to call each other, so you need grants in both directions.

On the **kitchen display app's** Cross-App settings, add an incoming grant from the POS app. Allow POST so the POS can send orders.

On the **POS app's** Cross-App settings, add an incoming grant from the kitchen display app. Allow POST so the kitchen can send status updates.

## Step 4: Wire Up the Order Flow

Now connect the two apps. In the **POS app's** project chat:

```
When a new order is placed, send it to the kitchen display app
so it shows up as a ticket
```

In the **kitchen display app's** project chat:

```
When the kitchen marks an order as ready, notify the POS app
so the cashier knows it's ready for pickup
```

## Step 5: Test the Full Loop

Use either app's project chat to walk through the whole flow:

```
Create a test order and verify it shows up on the kitchen display,
then mark it as ready and check that the POS got the update
```

Or ask Starcat to coordinate from the org dashboard:

> "Place a test order on the POS app with 2 burgers and a drink, check that it appeared on the kitchen display, then mark it ready and confirm the POS shows it as ready for pickup"

## Going to Production

Once the sandbox flow works:

1. Turn on **Allow agent access** and include **Production** on both apps, so Starcat can run the production test below
2. Publish both apps to production
3. Run a quick end-to-end test with Starcat:

> "Place a real test order through the POS and walk it all the way through the kitchen to pickup"