RELEASE NOTES
FreshGuard AI — Changelog
Every new feature, improvement, and bug fix — fully documented. FreshGuard AI is under active development.
v2.2.0
LatestJune 10, 2026- ✅Restored Protected Customer Data fields (firstName, lastName, email) in Recall Report — requires Shopify PCD approval.
- 🐛Fixed CSV Import: corrected double-escaped newline parsing and namespace mismatch that made imported batches invisible.
- 🐛Fixed Storefront Proxy: switched from admin auth to public app proxy auth for storefront access.
- 🐛Fixed Batch History: now records events from all sources (manual creation, CSV import, manual FEFO, webhook FEFO).
- 🐛Fixed Recall Report search: removed GraphQL tag query filter to bypass Shopify search index delay.
- ✅Updated Batches CSV export to include all documented fields (batch_number, expiry_date, quantities, cost, status, location, barcode, gtin, supplier, invoice).
- 🧹Cleaned up console.log statements from all production webhook handlers.
- 🧹Removed unused imports and dead code across routes.
- 🐛Fixed React anti-pattern: moved alert() from render to useEffect in batch import feedback.
- 📚Updated all documentation, guides, FAQ, and tutorial for accuracy.
- 🧹Removed hardcoded personal email from preferences defaults.
v2.1.0
PreviousJune 2026- ✅Multi-location support — real-time Shopify location selector in the Add Batch modal, powered by live GraphQL location fetching.
- ✅Batch history links — 'View inventory batch history' on the Products page is now a live clickable link to the Batch History tab, filtered by batch.
- ✅Batch name links — clicking any batch name in Inventory Batches navigates to that batch's full audit history.
- ✅Product admin links — clicking a product name in Inventory Batches opens the product directly in Shopify Admin.
- ✅'View Orders' links — now navigates to the Orders tab pre-filtered by the batch tag.
- ✅Orders CSV Export — the Export button on the Orders page generates a real downloadable CSV.
- ✅Discount form wiring — discount trigger days and percentage inputs in Preferences are now fully connected to the form submission.
- ✅Free plan downgrade — 'Continue on Free' now automatically cancels any active Pro subscriptions via Shopify's billing API.
- ✅Scope fix — added read_locations permission to shopify.app.toml for location API access.
- 🐛Removed unused fs import from products route that caused build warnings.
- 🐛Removed duplicate barcode field from batch creation modal.
- 🐛'Learn more' links in the batch modal now correctly point to the Guides page anchors instead of #.
v2.0.0
Major ReleaseJune 2026- 🆕Batch History & Audit Log — full searchable timeline of all batch events (creation, FEFO deductions, expirations, manual updates). Retains 500 events.
- 🆕Recall Report — find all customers who received a specific batch via FEFO order tagging. One-click CSV export for regulatory compliance.
- 🆕Automated Discount Sync (Pro) — configure discount trigger days and percentage in Preferences, then run batch discount sync to create Shopify Price Rules automatically.
- 🆕Storefront Expiry API — App Proxy JSON endpoint for theme developers to display live expiry dates on product pages.
- 🆕GTIN / GS1 Barcode field — industry-standard barcode tracking added to the batch creation form.
- 🆕Cost Per Unit tracking — record unit costs per batch for accurate financial analytics and wastage reporting.
- 🆕Packing Slip Integration — Liquid code snippet guide for adding lot number and expiry date to Shopify printed packing slips.
- 🆕Automated Product Tagging — auto-apply 'Expiring Soon' tag to products in Shopify when batches near expiry. Supports dynamic Shopify collections.
- 🆕Supplier field — record supplier/vendor name per batch for supply chain traceability.
- 🎨Glassmorphic dark UI redesign — premium static design with no hover animations per merchant preference.
- 📚Updated documentation, guides, FAQ, and changelog covering all v2.0 features.
v1.1.0
ImprovementJune 2026- ✅Setup page — added GTIN field definition and Metaobject schema provisioning.
- ✅Analytics Financial Dashboard — added Value at Risk, Wastage reporting, Inventory Health Score, and 4-month Expiration Forecast.
- ✅Financial CSV Export for Analytics tab.
- ✅Pro billing gate on Analytics — non-Pro users are redirected to the upgrade page.
- 🐛Fixed CSV column name mismatches in documentation.
- 🐛Fixed navigation links across all pages.
v1.0.0
Initial LaunchJune 2026- 🚀Launch of FreshGuard AI on the Shopify App Store.
- 🆕Batch and Expiry Date tracking using Shopify Metaobjects ($app:inventory_batch).
- 🆕Automated FEFO (First-Expired, First-Out) order deduction engine via orders/create webhook.
- 🆕Products dashboard — search and manage all Shopify product variants with batch tracking.
- 🆕Inventory Batches tab — list, filter, and manage all batches with status tracking.
- 🆕Orders & Allocations tab — view FEFO allocation history per order.
- 🆕CSV Data Import/Export for bulk inventory management.
- 🆕Free and Pro billing tiers via Shopify Billing API.
- 🆕GDPR-compliant privacy webhooks and privacy policy page.
- 🆕In-app Support Widget for merchant assistance.