First sync

After installing Shelfie you'll see an empty dashboard with a Sync Products call-to-action.

What the first sync does

1. Pulls every active product from your store (paginated 50 at a time)
2. For each product, records: title, vendor, type, tags, cost, price, inventory level, image
3. Pulls the last 365 days of orders to determine each product's lastSoldAt
4. Computes agingDays and assigns a risk level

For a 1,000-product store the first sync typically takes 30–90 seconds. A 10,000-product store may take 5–10 minutes.

What to do during the sync

The dashboard shows a progress banner. You can navigate away — the sync continues server-side. Refresh the page when you come back.

After the sync completes

The KPI tiles populate and the at-risk table fills with any product aging 30+ days. If everything in your catalog is fresh, you'll see "No at-risk products" and Value at Risk = $0. Come back in a few weeks.

Re-syncing

Click Sync Products any time to re-run. Subsequent syncs are full re-pulls (Shelfie doesn't yet do incremental sync; this is on the roadmap). Most stores run a manual sync weekly.

Shelfie also re-syncs automatically when:

• A product is updated in Shopify (via products/update webhook)
• The app is reinstalled