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/main-app-orders.md

View on GitHub
# Orders Tab (Order Creation, Payment Collection, Fulfillment)

**Scope:** This reference covers everything in the **Orders tab** — viewing orders, **creating orders (including adding products to orders)**, **collecting payment (cash, card, tap-to-pay, payment links)**, fulfillment, refunds, shipping labels, and receipts.

Fragment: `OrderListFragment` -- Tap `orders` bottom tab.

## Screen Identifiers

**Orders List** -- Compose. Test tags are declared in `OrderListTestTags.kt` and surface in the accessibility tree as `resource-id` **verbatim**, with no `com.woocommerce.android.dev:id/` prefix.

| Key Element | Identifier | Notes |
|-------------|-----------|-------|
| **Primary** | `order_list_screen` | Compose root of the orders list |
| Order list | `order_list` | LazyColumn holding the order rows |
| Order row | `order_list_order_<orderId>` | One per order; `<orderId>` is the remote order ID |
| Filters chip | `order_list_filters` | Opens order filters; `stateDescription` reports the active filter count |
| Search icon | `order_list_search_action` | contentDescription: "Search orders" |
| Search field | `order_list_search_field` | Only present after tapping the search icon |
| Barcode icon | `order_list_barcode_action` | contentDescription: "Scan Barcode" |
| Create order FAB | `order_list_create_order_fab` | contentDescription: "Create order" |
| Empty view | `order_list_empty` | Shown when no orders match; its action button is `order_list_empty_action` |
| Selection header | `order_list_selection_header` | Replaces the top app bar in multi-select mode |

**Order Detail** -- Fragment: `OrderDetailFragment` -- tap any order row

| Key Element | Identifier | Notes |
|-------------|-----------|-------|
| **Primary** | `orderDetail_container` | Main content container |
| Order status | `orderDetail_orderStatus` | Status card at top |
| Product list | `orderDetail_productList` | Products in the order |
| Payment info | `orderDetail_paymentInfo` | Payment details card |
| Customer info | `orderDetail_customerInfo` | Customer details card |
| Refunds info | `orderDetail_refundsInfo` | Visible if refunds exist |
| Notes list | `orderDetail_noteList` | Order notes section |
| Shipment tracking | `orderDetail_shipmentList` | Shipment tracking section |
| Shipping labels | `orderDetail_shippingLabelList` | Shipping labels section |

## Workflows

### Orders List

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Orders" tab | id: `orders` |
| 2 | Tap an order | order row in `order_list` -- `order_list_order_<orderId>` |
| 3 | Filter by status | tap `order_list_filters`, then pick a status |
| 4 | Search orders | tap `order_list_search_action`, then type into `order_list_search_field` |
| 5 | Create new order | FAB: `order_list_create_order_fab` |

**Tablet create order:** On tablets, the product selector and order summary are side-by-side. After selecting products, tap **"Recalculate"** in the totals section — totals show $0.00 until recalculated, and "Collect Payment" only appears after recalculation. On phones, the product selector is a separate screen.

### Order Status Change

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap order status card | id: `orderDetail_orderStatus` |
| 2 | Select new status | status list dialog |

### Issue Refund Flow

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Issue Refund" on order detail | text: "Issue Refund" |
| 2 | Select items to refund | item list with quantity selectors |
| 3 | Tap "Next" | next button |
| 4 | Review refund summary | refund amount, reason field, method |
| 5 | Tap "Issue Refund" | refund button |

### Add Order Note

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Add note" on order detail | add note button |
| 2 | Enter note text | note text field |
| 3 | Toggle "Email to customer" | email toggle switch |
| 4 | Tap "Add" | add button |

### Shipment Tracking

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Add tracking" on order detail | add tracking button |
| 2 | Select carrier/provider | provider list |
| 3 | Enter tracking number | tracking number field |
| 4 | Tap "Add" | add button |

### Order Fulfillment

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Fulfill" on order detail | fulfill button |
| 2 | Review fulfillment details | fulfillment screen |
| 3 | Mark complete | complete button |

### Shipping Labels (Create)

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Create Shipping Label" on order detail | create label button |
| 2 | Edit origin/destination address | address fields |
| 3 | Select/create package | package selector |
| 4 | Select carrier and rate | carrier rate list |
| 5 | (International) Fill customs form | customs form fields |
| 6 | Purchase label | purchase button |

### Shipping Labels (Print/Refund)

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap existing shipping label | label row in shipping labels section |
| 2 | Tap "Print" | print button |
| 3 | Select paper size | paper size dialog |
| 4 | (Or) Tap "Refund" | refund button |

### Collect Payment

Payment method selection screen offers multiple options depending on store setup.

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "Collect Payment" on order detail | collect payment button |
| 2 | Select payment method | method selection screen |
| 2a | **Card Reader (Bluetooth)** | card reader option |
| 2b | **Tap to Pay (NFC)** | tap to pay option |
| 2c | **Cash** | cash option -> change due calculator |
| 2d | **Share Payment Link** | share link option -> Android share sheet |
| 2e | **Scan to Pay (QR)** | QR option -> displays QR code |
| 3 | Payment completed | success screen |

### Edit Order

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap edit icon in toolbar | menu: `menu_edit_order` |
| 2 | Edit products, customer, shipping, fees, etc. | order creation/edit screen |
| 3 | Save changes | save button |

### Bulk Status Update (from Orders List)

| Step | Action | Element |
|------|--------|---------|
| 1 | Long-press to enter selection mode | order row -- `order_list_order_<orderId>` |
| 2 | Select more orders | tap further rows; per-row indicator `order_list_selection_indicator_<orderId>` |
| 3 | Open the selection menu | `order_list_selection_overflow` -- contentDescription: "More options" |
| 4 | Tap "Update status" | `order_list_selection_update_status` inside `order_list_selection_menu` |
| 5 | Confirm status change | status list dialog |
| -- | Exit selection mode | `order_list_selection_close` |

### Trash Order

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap trash button on order detail | id: `orderDetail_trash` |
| 2 | Confirm deletion | confirmation dialog |

### Receipt

| Step | Action | Element |
|------|--------|---------|
| 1 | Tap "See receipt" on order detail | receipt button |
| 2 | Print receipt | print button |
| 3 | Email receipt | email button |

### Customer Contact (from Order Detail)

| Action | Element |
|--------|---------|
| Email customer | email icon in customer info card |
| Call customer | phone icon in customer info card |
| SMS customer | SMS option in phone menu |
| WhatsApp customer | WhatsApp option in phone menu |
| Telegram customer | Telegram option in phone menu |
| Edit shipping address | tap shipping address section |
| Edit billing address | tap billing address section |
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