Skip to main content

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.

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 the Cofounder Agent 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. Set Agent Callable Environments to both on both apps
  2. Publish both apps to production
  3. Run a quick end-to-end test with the Cofounder:
“Place a real test order through the POS and walk it all the way through the kitchen to pickup”