From a74c9c10712a194a468c4c4ce7d068bda2763e07 Mon Sep 17 00:00:00 2001 From: Frontend Frankie Date: Fri, 20 Mar 2026 02:08:15 +0000 Subject: [PATCH] Add Phase 2 content: onboarding guides and FAQ Onboarding guides cover the five core user flows: getting started, connecting store accounts, setting up price alerts, reading the dashboard, and comparing stores. FAQ addresses common questions about how CartSnitch works, data privacy, supported stores, and troubleshooting. All guides include screenshot placeholders for integration once staging is available (blocked on CAR-60). Ref: CAR-114 Co-Authored-By: Paperclip --- content/marketing/faq.md | 118 ++++++++++++++++++ .../marketing/onboarding/comparing-stores.md | 57 +++++++++ .../marketing/onboarding/connecting-stores.md | 72 +++++++++++ .../marketing/onboarding/getting-started.md | 95 ++++++++++++++ .../onboarding/reading-your-dashboard.md | 67 ++++++++++ .../marketing/onboarding/setting-up-alerts.md | 58 +++++++++ 6 files changed, 467 insertions(+) create mode 100644 content/marketing/faq.md create mode 100644 content/marketing/onboarding/comparing-stores.md create mode 100644 content/marketing/onboarding/connecting-stores.md create mode 100644 content/marketing/onboarding/getting-started.md create mode 100644 content/marketing/onboarding/reading-your-dashboard.md create mode 100644 content/marketing/onboarding/setting-up-alerts.md diff --git a/content/marketing/faq.md b/content/marketing/faq.md new file mode 100644 index 0000000..b5effee --- /dev/null +++ b/content/marketing/faq.md @@ -0,0 +1,118 @@ +--- +title: "CartSnitch FAQ" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "Frequently asked questions about CartSnitch — how it works, data privacy, supported stores, and troubleshooting." +--- + +# Frequently Asked Questions + +--- + +## General + +### What is CartSnitch? + +CartSnitch is a free tool that tracks grocery prices, detects shrinkflation, and compares prices across stores. Connect your store loyalty accounts and CartSnitch does the rest — no barcodes, no receipt scanning, no manual entry. + +### How does CartSnitch track my prices? + +When you connect a store loyalty account (like mPerks, Kroger Plus, or Target Circle), CartSnitch securely accesses your purchase history. It records what you bought, what you paid, and the package size. Over time, this builds a complete picture of your grocery spending. + +### What is shrinkflation? + +Shrinkflation is when a brand reduces the size or quantity of a product while keeping the price the same (or raising it). A cereal box that was 15 oz last year and 13.5 oz today — at the same price — is shrinkflation. CartSnitch tracks unit prices (price per ounce, per count) to catch this automatically. + +### Is CartSnitch free? + +Yes. CartSnitch is free to use. No subscription, no trial period, no credit card required. + +--- + +## Stores & Data + +### Which stores does CartSnitch support? + +Currently: **Meijer**, **Kroger**, and **Target**. We're adding more stores regularly — Walmart, Costco, and Aldi are on the roadmap. + +### How do I connect my store account? + +Go to **Settings > Connect a Store**, choose your store, and enter the email and password you use for that store's loyalty program. CartSnitch imports your purchase history within minutes. See our [Connecting Your Store Accounts](onboarding/connecting-stores.md) guide for details. + +### Can I connect multiple stores? + +Yes. Connect as many supported stores as you have accounts for. More stores means better price comparisons and more complete tracking. + +### Does CartSnitch work if I don't have a loyalty account? + +Not yet. CartSnitch currently requires a store loyalty account to import your purchases. If you don't have one, signing up for mPerks, Kroger Plus, or Target Circle is free and takes a couple of minutes. + +--- + +## Privacy & Security + +### Is my store login information safe? + +Yes. Your store credentials are encrypted and stored securely. CartSnitch uses them only to access your purchase history — nothing else. + +### What data does CartSnitch collect? + +CartSnitch collects: +- Your purchase history (items, prices, dates) +- Product information (names, brands, package sizes) +- Price data across stores + +CartSnitch does **not** collect: +- Payment methods or credit card numbers +- Personal demographics beyond your account info +- Location data +- Data from any source other than your connected store accounts + +### Does CartSnitch sell my data? + +No. CartSnitch does not sell, share, or monetize your personal purchase data. Aggregated, anonymized price trends may be used in public-facing content (like our blog posts about shrinkflation), but your individual data is never shared. + +### Can I delete my data? + +Yes. You can disconnect any store at any time, and you can delete your CartSnitch account entirely. When you delete your account, all of your data is permanently removed. + +--- + +## Features + +### How do price alerts work? + +Set a target price for any product. CartSnitch monitors prices from your connected stores and notifies you when the price drops to your target or below. See our [Setting Up Price Alerts](onboarding/setting-up-alerts.md) guide. + +### How does store comparison work? + +For any product, CartSnitch shows you what it costs at each of your connected stores, sorted from cheapest to most expensive. It highlights the best deal and tells you how much you'd save. See our [Comparing Stores](onboarding/comparing-stores.md) guide. + +### What are coupons in CartSnitch? + +CartSnitch surfaces digital coupons from your connected store accounts. You can browse available deals, see expiration dates, and copy coupon codes — all in one place instead of checking each store's app separately. + +### Does CartSnitch work offline? + +Yes. CartSnitch is a progressive web app (PWA) that caches your data locally. You can browse your purchase history, check product prices, and view your shopping list even without an internet connection. New data syncs when you're back online. + +--- + +## Troubleshooting + +### My purchases aren't showing up. + +Some stores take a few hours to make recent purchases available. If you just shopped, check back in a few hours. If it's been more than 24 hours, try disconnecting and reconnecting the store in **Settings > Connect a Store**. + +### I can't connect my store account. + +Make sure you're using the same email and password you use on the store's website or app. If you recently changed your password, use the new one. If your store uses two-factor authentication, you may need to adjust those settings temporarily. + +### The app isn't loading or looks broken. + +Try refreshing the page. If you installed CartSnitch to your home screen, try opening it in your browser instead. Clear your browser cache if the issue persists. + +### How do I install CartSnitch on my phone? + +Visit CartSnitch in your mobile browser. You'll see a prompt to "Add to Home Screen" — tap it and CartSnitch gets its own app icon. No app store download needed. diff --git a/content/marketing/onboarding/comparing-stores.md b/content/marketing/onboarding/comparing-stores.md new file mode 100644 index 0000000..5f8b1dc --- /dev/null +++ b/content/marketing/onboarding/comparing-stores.md @@ -0,0 +1,57 @@ +--- +title: "Comparing Stores" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "How to use CartSnitch's store comparison feature to find the best prices." +--- + +# Comparing Stores + +The same item at two different stores can differ by $1-2 on any given day. CartSnitch's store comparison shows you exactly where each product costs less — so you can make smarter choices about where to shop. + +--- + +## How to Compare + +1. Go to **Products** and find the item you want to compare +2. Tap the product to open its detail page +3. Tap **Compare Stores** + +CartSnitch shows every connected store that carries the product, sorted from cheapest to most expensive. + +`[SCREENSHOT PLACEHOLDER: Store comparison page for a product showing Meijer, Kroger, and Target prices sorted by lowest first]` + +--- + +## What the Comparison Shows + +For each store, you'll see: +- **Store name and icon** +- **Current price** +- **Last updated date** — when CartSnitch last saw this price +- **Best price highlight** — the cheapest option gets a green border + +If there's a meaningful price difference, a savings banner appears at the top: "Save $1.47 by shopping at Meijer." + +--- + +## Getting the Most Out of Comparisons + +**Compare your regulars.** The biggest savings come from items you buy every week. A $0.30 difference on eggs doesn't feel like much once, but over a year that's $15 — and it adds up across your whole cart. + +**Check before you shop.** Before heading out, search for the 5-10 items on your list and compare. You might find that this week, Kroger beats Meijer on dairy but Meijer wins on produce. A quick check takes 2 minutes and can save you $5-10 per trip. + +**Connect multiple stores.** Store comparison works best when you have at least two stores connected. The more stores you link, the more comparison data CartSnitch can show. + +--- + +## Why Prices Differ + +Store pricing is complicated. Factors include: +- **Regional pricing** — the same chain can charge different amounts in different zip codes +- **Loss leaders** — stores intentionally underprice certain items (like milk or bananas) to get you in the door +- **Promotions and sales cycles** — most grocery items rotate through sales every 6-8 weeks +- **Store brand vs. national brand** — store brands are typically 20-30% cheaper for equivalent products + +CartSnitch tracks all of this so you can see the patterns without doing the research yourself. diff --git a/content/marketing/onboarding/connecting-stores.md b/content/marketing/onboarding/connecting-stores.md new file mode 100644 index 0000000..3cfc8c9 --- /dev/null +++ b/content/marketing/onboarding/connecting-stores.md @@ -0,0 +1,72 @@ +--- +title: "Connecting Your Store Accounts" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "Step-by-step guide for linking Meijer, Kroger, and Target loyalty accounts to CartSnitch." +--- + +# Connecting Your Store Accounts + +CartSnitch pulls your purchase history directly from your store loyalty accounts. No receipt photos, no barcode scanning — just your existing login credentials. + +--- + +## Supported Stores + +| Store | Loyalty Program | What CartSnitch Imports | +|---|---|---| +| **Meijer** | mPerks | Purchase history, item prices, digital coupons | +| **Kroger** | Kroger Plus | Receipts, item prices, digital coupons | +| **Target** | Target Circle | Purchase history, deals | + +More stores are on the roadmap (Walmart, Costco, Aldi). Request yours in the app. + +--- + +## How to Connect + +1. Open CartSnitch and go to **Settings** +2. Tap **Connect a Store** +3. Choose your store (Meijer, Kroger, or Target) +4. Enter the email and password you use for that store's loyalty program +5. Tap **Connect** + +CartSnitch will verify your credentials and start importing your purchases. This usually takes under a minute for your recent history. + +`[SCREENSHOT PLACEHOLDER: Account Linking page showing Meijer connected, Kroger connected, and Target available to connect]` + +--- + +## What We Access (and What We Don't) + +**We access:** +- Your purchase history (what you bought, when, and how much you paid) +- Item prices and package sizes +- Digital coupon availability + +**We never access:** +- Payment methods or credit card numbers +- Personal information beyond what's needed to log in +- Your store account settings or loyalty points balance + +Your store credentials are encrypted and stored securely. CartSnitch never shares your data with third parties. + +--- + +## Disconnecting a Store + +Changed your mind? Go to **Settings > Connect a Store**, find the connected store, and tap **Disconnect**. CartSnitch stops importing new data immediately. Your existing purchase history in CartSnitch remains available unless you delete your account. + +--- + +## Troubleshooting + +**"Connection failed" error** +Double-check that you're using the same email and password you use to log into the store's website or app. If you recently changed your store password, use the new one. + +**Purchases aren't showing up** +Some stores take a few hours to make recent purchases available through their systems. If you just shopped, check back later. If it's been more than 24 hours, try disconnecting and reconnecting the store. + +**Two-factor authentication** +If your store account uses two-factor authentication, you may need to temporarily adjust your security settings to connect. We're working on native 2FA support. diff --git a/content/marketing/onboarding/getting-started.md b/content/marketing/onboarding/getting-started.md new file mode 100644 index 0000000..e70f04c --- /dev/null +++ b/content/marketing/onboarding/getting-started.md @@ -0,0 +1,95 @@ +--- +title: "Getting Started with CartSnitch" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "First-time user onboarding guide — from signup to first savings insight." +--- + +# Getting Started with CartSnitch + +Welcome to CartSnitch. Here's how to go from zero to tracking your grocery prices in about two minutes. + +--- + +## Step 1: Create Your Account + +Open CartSnitch and tap **Create Account**. Enter your name, email, and a password. That's it — no credit card, no subscription, no trial period. + +Once you're in, you'll land on your dashboard. It'll be empty for now. That changes fast. + +--- + +## Step 2: Connect a Store + +This is where CartSnitch gets useful. Head to **Settings > Connect a Store** and link at least one loyalty account: + +- **Meijer** — your mPerks account +- **Kroger** — your Kroger Plus account +- **Target** — your Target Circle account + +CartSnitch uses your store credentials to pull your purchase history automatically. No receipt scanning. No barcode swiping. Your past purchases start appearing within minutes. + +For detailed instructions, see the [Connecting Your Store Accounts](connecting-stores.md) guide. + +--- + +## Step 3: Explore Your Dashboard + +Once a store is connected, your dashboard comes to life: + +- **Recent purchases** — your last few shopping trips, pulled directly from your store account +- **Price trends** — sparkline charts showing how prices are moving on everyday items like eggs and milk +- **Triggered alerts** — if any prices you're watching have dropped, you'll see it right at the top + +`[SCREENSHOT PLACEHOLDER: Authenticated dashboard showing recent purchases, sparkline charts, and alert banner]` + +--- + +## Step 4: Set Up a Price Alert + +Spot something you buy regularly? Set a price alert so CartSnitch tells you when the price drops. + +1. Go to **Products** and search for the item +2. Tap the product to see its price history +3. Tap **Set Alert** and enter your target price +4. CartSnitch notifies you the moment it hits + +For the full walkthrough, see [Setting Up Price Alerts](setting-up-alerts.md). + +--- + +## Step 5: Compare Stores + +If you've connected more than one store, you can compare prices side by side. On any product page, tap **Compare Stores** to see where it costs less. + +CartSnitch highlights the cheapest option and tells you exactly how much you'd save by switching stores. + +See the [Comparing Stores](comparing-stores.md) guide for details. + +--- + +## What Happens Next + +CartSnitch keeps working in the background. Every time you shop, your new purchases are imported automatically. Prices are tracked. Shrinkflation is flagged. You don't need to do anything — just shop like you normally would and check in when you want to see what's changed. + +--- + +## Quick Reference + +| Feature | Where to find it | +|---|---| +| Connect a store | Settings > Connect a Store | +| View purchases | Purchases tab | +| Search products | Products tab | +| Set price alerts | Product detail > Set Alert | +| Compare stores | Product detail > Compare Stores | +| Browse coupons | Coupons tab | + +--- + +## Installing CartSnitch on Your Phone + +CartSnitch is a web app that works like a native app on your phone. When you visit CartSnitch in your mobile browser, you'll see an "Add to Home Screen" prompt. Tap it, and CartSnitch gets its own icon on your home screen — no app store download needed. + +It works offline too, so you can check prices and your shopping list even when you're in a store with spotty reception. diff --git a/content/marketing/onboarding/reading-your-dashboard.md b/content/marketing/onboarding/reading-your-dashboard.md new file mode 100644 index 0000000..90ce700 --- /dev/null +++ b/content/marketing/onboarding/reading-your-dashboard.md @@ -0,0 +1,67 @@ +--- +title: "Reading Your Dashboard" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "Guide to understanding your CartSnitch dashboard — purchases, price trends, and alerts at a glance." +--- + +# Reading Your Dashboard + +Your dashboard is your home base. It gives you a quick read on what's happening with your grocery spending without digging through menus. + +--- + +## What You'll See + +### Triggered Alerts Banner + +If any of your price alerts have fired, a green banner appears at the top of the dashboard. It tells you how many alerts triggered and links directly to the Alerts page. This is your "time to buy" signal. + +### Price Trend Sparklines + +Small charts that show recent price movement for key items. These aren't detailed analyses — they're quick visual checks. Is the line going up or down? That's what they're for. + +Each sparkline shows: +- **The product name** (e.g., "Large Eggs — Meijer") +- **The current price** +- **A trend line** over recent data points + +`[SCREENSHOT PLACEHOLDER: Dashboard sparkline cards showing egg and milk price trends with current prices]` + +### Recent Purchases + +The last three shopping trips from your connected stores. Each card shows: +- **Store name and icon** +- **Date** of the purchase +- **Total spent** +- **Number of items** + +Tap any purchase to see the full receipt breakdown with individual item prices. + +### Quick Actions + +Links to the features you'll use most: +- **Products** — search and browse tracked products +- **Alerts** — manage your price watches +- **Coupons** — see available deals from your stores + +--- + +## When You First Sign Up + +The dashboard starts empty. That's normal — it fills in as soon as you connect a store account. Within minutes of connecting, you'll see your purchase history and price data start flowing in. + +If you've connected a store but the dashboard is still empty after 15 minutes, try pulling down to refresh, or check **Settings > Connect a Store** to verify the connection status. + +--- + +## Dashboard vs. Other Pages + +The dashboard is the summary. For deep dives: +- **Purchases** gives you your full purchase history with search and filters +- **Products** lets you explore individual product prices and history +- **Alerts** shows all your price watches in detail +- **Coupons** lists available deals from your connected stores + +Think of the dashboard as the headlines. The other pages are the full articles. diff --git a/content/marketing/onboarding/setting-up-alerts.md b/content/marketing/onboarding/setting-up-alerts.md new file mode 100644 index 0000000..8957a03 --- /dev/null +++ b/content/marketing/onboarding/setting-up-alerts.md @@ -0,0 +1,58 @@ +--- +title: "Setting Up Price Alerts" +status: draft +version: 1.0 +last_updated: 2026-03-20 +description: "How to create, manage, and use price alerts in CartSnitch." +--- + +# Setting Up Price Alerts + +Price alerts let you set a target price for any product. When the price drops to your target (or below), CartSnitch notifies you. It's the easiest way to stock up when prices are right. + +--- + +## Creating an Alert + +1. Go to **Products** and search for the item you want to watch +2. Tap the product to open its detail page +3. Tap the **+ New Alert** button +4. Select the store you want to watch (or all stores) +5. Enter your target price — this is the price at or below which you want to be notified +6. Tap **Create Alert** + +That's it. CartSnitch checks prices automatically and notifies you when your target is hit. + +`[SCREENSHOT PLACEHOLDER: Price Alerts page showing triggered alerts at top and watching alerts below, with + New Alert button]` + +--- + +## How Alerts Work + +CartSnitch tracks prices from your connected stores. When a price update comes in that matches or beats your target, the alert triggers. + +Triggered alerts show up in two places: +- **Your dashboard** — a green banner at the top shows how many alerts have fired +- **The Alerts page** — triggered alerts are separated from active watches so you can see what's ready to act on + +--- + +## Managing Your Alerts + +### Viewing alerts +Go to the **Alerts** tab to see all your alerts. They're grouped into: +- **Triggered** — prices have hit your target. Time to buy. +- **Watching** — still waiting for the price to drop. + +### Deleting an alert +Tap any alert card and hit **Delete** to remove it. You can always create a new one later. + +--- + +## Tips for Better Alerts + +**Use price history to set realistic targets.** Before creating an alert, check the product's price history chart. If eggs have bounced between $3.49 and $4.99 over the past six months, a target of $3.49 is realistic. A target of $1.99 probably isn't. + +**Watch staples, not impulse buys.** Alerts are most valuable for things you buy every week — milk, eggs, bread, chicken. A $0.50 savings on something you buy 50 times a year is $25 back in your pocket. + +**Set alerts across stores.** If you've connected multiple stores, set the alert to watch all of them. The same product can vary by $1-2 between stores on any given week.