woocommerce/woocommerce-android / .agents/skills/verify-on-device
verify-on-device
VerifiedBuild, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 39.6 KB |
| references/agent-auto-login.md | markdown | 7.0 KB |
| references/main-app-dashboard.md | markdown | 3.1 KB |
| references/main-app-login.md | markdown | 3.9 KB |
| references/main-app-more.md | markdown | 3.9 KB |
| references/main-app-navigation.md | markdown | 3.9 KB |
| references/main-app-orders.md | markdown | 7.3 KB |
| references/main-app-products.md | markdown | 6.0 KB |
| references/pos-navigation.md | markdown | 4.9 KB |
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 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |