Skip to content

woocommerce/woocommerce-android / .agents/skills/verify-on-device

verify-on-device

Verified

Build, install, and visually verify the app on an Android emulator or device. Uses the Android CLI for agents (android) when available with a full mobile-mcp/adb fallback.

references/pos-navigation.md

View on GitHub
# POS Navigation Reference

Navigation map for the WooCommerce Point of Sale (POS) feature.
POS runs in a **separate Activity** (`WooPosActivity`), uses **pure Compose navigation** (no Fragments), and is **landscape-only** with a split-pane layout.

## Quick Launch

Skip all main app navigation -- launch POS directly:

```bash
adb -s <device_id> shell am start -n com.woocommerce.android.dev/com.woocommerce.android.ui.woopos.root.WooPosActivity
```

**Prerequisites:** App must be logged in. If POS shows an eligibility screen, the store may not have POS enabled.

## Feature Tree

```
WooPosActivity (landscape)
|
+-- Splash Screen (loading/eligibility check)
|   +-- -> Eligibility Screen (if store not eligible)
|
+-- Home Screen (split-pane layout: Products | Cart | Totals)
    |
    +-- LEFT PANE: Product/Coupon Browser (~65%)
    |   +-- Products Tab
    |   |   +-- Product Grid (with images, prices)
    |   |   +-- Search Products
    |   |   +-- -> Product Variations Modal
    |   |   +-- Barcode Scanning
    |   +-- Coupons Tab
    |       +-- Coupon List
    |       +-- Search Coupons
    |       +-- -> Create Coupon (external activity)
    |
    +-- RIGHT PANE: Cart (~35%)
    |   +-- Cart Items (remove)
    |   +-- Checkout button
    |
    +-- CHECKOUT (scrolls right to show Totals pane full-screen)
    |   +-- Totals (subtotal, tax, discounts)
    |   +-- -> Card Payment Screen
    |   |   +-- -> Payment Success Screen
    |   |       +-- -> Email Receipt Screen
    |   +-- -> Cash Payment Screen
    |       +-- -> Payment Success Screen
    |           +-- -> Email Receipt Screen
    |
    +-- FLOATING TOOLBAR (bottom-left)
        +-- -> Orders
        |   +-- -> Order Detail
        |       +-- -> Issue Refund
        |       |   +-- Refund Reason Screen
        |       +-- -> Email Receipt
        +-- -> Settings (master-detail pane)
        |   +-- Store (Receipt preferences)
        |   +-- Hardware
        |   |   +-- Card Reader Setup
        |   |   +-- Barcode Scanner Setup
        |   +-- Local Catalog
        |   +-- Help
        +-- -> Exit POS (confirmation dialog -> returns to MainActivity)
```

## POS Screen Identifiers

POS screens are 100% Compose. Elements are identified via `Modifier.testTag()` or by display text/contentDescription.

### Test Tags (defined in `WooPosTestTags`)

| Test Tag | Screen/Element |
|----------|---------------|
| `woo_pos_product_item` | Product card in grid |
| `woo_pos_checkout_button` | Checkout / Charge button |
| `woo_pos_cash_payment_button` | Cash payment option |
| `woo_pos_complete_payment_button` | Mark payment as complete (cash) |
| `woo_pos_new_order_button` | New order (after payment success) |
| `woo_pos_success_checkmark_icon` | Payment success screen checkmark |
| `woo_pos_cart_items_count` | Cart item count badge |

### Screen Detection

| Screen | How to Detect |
|--------|---------------|
| Home (product browsing) | `woo_pos_product_item` elements present |
| Cart with items | `woo_pos_checkout_button` visible |
| Checkout/Totals | Text containing "Subtotal" or "Total" with payment buttons |
| Card Payment | Text "Tap, insert, or swipe" or card reader status |
| Cash Payment | `woo_pos_complete_payment_button` visible |
| Payment Success | `woo_pos_success_checkmark_icon` visible |
| Orders List | Text "Orders" as screen title, order rows with # numbers |
| Order Detail | Order number header with "Issue refund" button |
| Settings | Text "Settings" with category list (Hardware, Store, etc.) |
| Eligibility | Text about POS requirements or plan upgrade |

## Key Workflows

Each step shows: action and element to find.

### Checkout Flow

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap a product to add to cart | tag: `woo_pos_product_item` |
| 2 | Verify cart updated | tag: `woo_pos_cart_items_count` |
| 3 | Tap Checkout | tag: `woo_pos_checkout_button` |
| 4a | **Card:** tap card payment button | text: card payment option |
| 4b | **Cash:** tap cash, then complete | tags: `woo_pos_cash_payment_button` -> `woo_pos_complete_payment_button` |
| 5 | Verify payment success | tag: `woo_pos_success_checkmark_icon` |
| 6 | Tap New Order or Email Receipt | tag: `woo_pos_new_order_button` |

### Orders & Refund Flow

| Step | Action | Element |
|------|--------|---------|
| 1 | Open toolbar menu | bottom-left menu button |
| 2 | Tap "Orders" | text: "Orders" |
| 3 | Wait for orders list | order rows with `#` numbers |
| 4 | Select an order | tap order row |
| 5 | Tap "Issue refund" | text: "Issue refund" |
| 6 | Select items to refund | items pre-selected, tap "Continue" |
| 7 | Review and confirm refund | verify amounts, tap "Continue" |
| 8 | Confirm in dialog | tap confirmation button |

### Other Events

| Action | Element |
|--------|---------|
| POS loaded | splash -> home |
| Open Settings | toolbar menu -> "Settings" |
| Close Settings | back / close button |
| Exit POS | toolbar menu -> "Exit POS" -> confirm |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall