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

# How PopUp works

> The full selling flow from setup to checkout.

## The two-part setup

Once PopUp is installed, it's time to build your catalog. There are two parts that work together:

**PopUp Admin** (your phone browser or computer) — where you manage your product catalog: add products, set prices, assign categories, and customize your product tiles. Do these updates before market day.

**Shopify POS** (your phone, in the POS app) — where you sell. You open the PopUp tile, find a product, enter the weight or quantity, and add it to the cart. The sale goes through Shopify as a custom sale.

## On market day

Here's what a typical sale looks like:

1. Open the Shopify POS app on your phone
2. Tap the **PopUp** tile on the POS home screen
3. Find your product — browse by category or search by name
4. For weight-based items: Enter the weight on the keypad
5. Tap **Add to Cart** — PopUp calculates the price automatically
6. Continue adding items, then check out through Shopify POS as normal

The whole process takes a few seconds per item once you're set up.

## Weight vs. fixed-price products

**Weight products** — you enter the weight at the time of sale. PopUp multiplies weight × price to get the line item total. Supports lbs, oz, kg, and g.

**Fixed-price (item) products** — tap to add to the cart at the set price. Good for pre-packaged goods or add-ons with a set price.

You can mix both types in the same transaction.

## Sync

Whenever you save a product or category in the Shopify Admin, PopUp syncs your catalog automatically. You can also trigger a manual sync from a desktop via **Settings → Sync Now** before heading to market.