Your 10-minute tour

How to use
KindlyChecked.

Six short sections that walk you through your first scan, your first allergen setup, and your first "oh, this changes everything" moment. Designed to be read in order, top to bottom.

~10 min read
·
6 sections
·
Interactive demos inline
1 The fundamentals

Your first scan.

You point your phone at a barcode. We do the rest. Here's exactly how it works the first time.

  1. Open the app
    Tap the KindlyChecked icon on your home screen, or open the URL in your browser. The home screen shows a big lime card that says "The label, kindly checked."
  2. Tap the camera button
    It's the lime circle at the bottom-center of every screen, or the "Scan a product" button in the lime card. First time, your phone will ask for camera permission — say yes.
  3. Aim at the barcode
    Line up the barcode within the four lime corners. A scanning beam pulses across the frame — you don't need to tap anything. We detect as soon as it's clear, usually in under a second.
  4. Watch the green flash
    When we detect the barcode, the frame flashes brighter green and a check mark pops up. About 150ms later, you're on the result page.
📱
iPhone users: The camera only works in Safari. If you opened the link in Chrome, the camera button will say "use Safari instead." Apple restriction, not our bug.
Stuck? Three things to check
  • 1
    Camera not opening Permission was denied. Open browser settings, find KindlyChecked, allow Camera. Then refresh the page.
  • 2
    Barcode won't detect Move 4–6 inches from the product. Steady your hand. If the package is wrinkled or shiny, flatten it.
  • 3
    Got a "not found" screen That product isn't in our database yet. We'll show you a one-tap link to add it — takes 30 seconds and helps everyone.
2 Understanding what you see

Reading the score.

Every product gets a number from 1 to 100, a color, and a verdict. Here's exactly what each band means.

The score is the headline answer — but it's not the whole story. Right below the product card you'll see a plain-language takeaway: one or two sentences in plain English explaining what kind of product this is and what's actually pulling the score. Calibrated to the score band — a Strong product gets a "no real notes here," a Heavy one gets an honest "best treated as an occasional indulgence." Below that, the breakdown: a list of reasons that explain why it scored what it did. Some are good (lime checkmarks), some are flags (red triangles).

Tap any flag to expand it into a full explanation — what the ingredient is in plain English, the specific concern (with named regulatory bodies), and an evidence level so you know how confident the science is. Tap the Ingredients section to see the full ingredient list straight from the package — same data the algorithm uses, no filtering, no spin.

At the bottom of every result, the "Where we got this info" section lists our actual sources — Nutri-Score, IARC, EFSA, FDA, EWG, EPA — with direct links so you can verify anything we tell you.

75 – 100
Strong
Strong nutritional profile. Clean ingredients.
50 – 74
Solid
A reasonable choice. Some minor flags but nothing alarming.
25 – 49
Mixed
Notable concerns worth knowing about. We'll show alternatives if better ones exist.
1 – 24
Heavy
Significant nutritional or ingredient concerns. Stronger alternatives usually exist.
🧮
How the math works: For food, it's 70% Nutri-Score + 30% additives. For cosmetics and cleaners, we start at 100 and subtract for each hazardous ingredient. Sources are cited in the app under Profile → About.
📋
Read the actual label. Every result page has a collapsible Ingredients card with the full list pulled from Open Food Facts — the same source we use for scoring. If you ever want to verify a flag, audit the data, or just see what's actually in something, it's one tap. If anything looks wrong or out of date, the "Doesn't look right?" link routes you straight to the OFF entry to fix it for everyone.
🎓
Flags that teach, not just warn. Tap any red flag to expand it. You'll get a plain-English description of what the ingredient is, the specific concern with named regulatory bodies (IARC, EFSA, FDA), and an honest evidence level — Strong, Moderate, Mixed, Emerging, or Limited. We'd rather you understand than be scared.
💬
Plain-language take at the top. Every result now opens with one or two sentences in plain English — what kind of product this is, what pulled the score, whether it's actually worth worrying about. Calibrated to the score band so a Strong product gets affirmation and a Heavy one gets an honest "treat this as an occasional indulgence." Reads like a friend who knows nutrition, not an alarm system.
📊
Tap your stats to see patterns. The three stat cards on home (Scanned, Avg score, Saved) are tappable. Open "Scanned" or "Avg score" to see What we noticed — your average score lately, score-band distribution, brands you scan most often. All computed on your phone from your scan history. Nothing sent anywhere.
📅
Learn one ingredient a day. A small Today's ingredient card sits on the home screen. One rotating educational entry per day — sodium nitrite today, sucralose tomorrow. Tap to expand for the full explanation. No streaks, no notifications, no commitment. Skip whenever, it'll be there tomorrow.
🔦
Stuck on a scan? The app will help. If you've had the scanner open for about 12 seconds without a successful scan, a small "Having trouble?" card slides up from the bottom. Three quick tips (distance, glare, lighting) plus a one-tap shortcut to switch to manual barcode entry. Dismiss it and it won't bug you again this session.
🔗
Share a product and it actually goes somewhere. Tap the share icon at the top of any result and you'll get a clean shareable link like kindlychecked.app/p/028400090506. When your friend taps it, the product opens straight to the result — they don't need to install anything to see what you're talking about. The share text leads with the verdict band (Strong / Solid / Mixed / Heavy), the product name and score, and a brief reason if there are flags.
🚫
Sometimes we won't give you a score. If a product is in the database but its ingredient list isn't, you'll see "We can't check this one yet" instead of a number. That's deliberate. A cosmetic with no ingredients on file has zero flagged ingredients — but that's zero data, not zero problems, and scoring it 100/100 would be inventing a verdict out of an empty file. We'd rather tell you we don't know. Scan or search something else, or check back later once a contributor adds the ingredients.
🔍
The scanner tells you what it does. A small two-line hint under the detection frame reads "Scans packaged food, cosmetics, and cleaners. Food coverage is strongest." It's there so you know what to expect before you scan — food scans reliably, cosmetics and cleaners work but pull from smaller community databases where gaps are more common. Hidden automatically when the "trouble scanning?" nudge or manual-entry sheet is up.
🗂️
Your saved scans, organized by type. Once you've saved 5+ products, a small row of type chips appears above the verdict chips on the Saved tab (Food · Cosmetics · Cleaners, each with its count). Filter by type first, then by verdict-band within — or leave it on "All types" to see everything. And in the Insights view, there's now a "By type" card showing how your scans distribute across the three types. Tap any row and you jump to Saved pre-filtered by that type. Small collections don't need the filter UI, so it stays hidden until your saved list is big enough to benefit.
⌨️
Don't have the barcode? Type the name. "Or search by name" sits right under the Scan button on home. Tap it, type "cheerios" or "shampoo" or "dish soap," and you'll see US-filtered matches with preview scores in about half a second. Tap any result to open it like a normal scan. Search covers all three databases — food, cosmetics, and cleaners — with results interleaved by type so no single category dominates. Each result carries a small type tag (Food / Cosmetic / Cleaner) so the mix is legible. Food coverage is still deepest because Open Food Facts is the largest of the three databases, but you can now search across everything the app can scan.
🌐
When something isn't found. We check three community databases in sequence — Open Food Facts (packaged food, 3M+ products), Open Beauty Facts (cosmetics and personal care), and Open Products Facts (cleaners and household products). If none of them have your barcode, you'll land on a "Not in the databases yet" page that acknowledges what we searched and where coverage tends to be thin. Food coverage is strong. Cosmetics and cleaners are smaller databases — you may run into more gaps there. And we don't cover pet food yet — it's on our list, but it's a genuinely different scoring domain (Nutri-Score doesn't apply to pets, additive concerns differ by species). We want to get it right before we build it, and it'll live in a sister app rather than bolted into KindlyChecked. Our best suggestion when something isn't found is usually to try another scan. If you're already familiar with contributing to open databases, there's a small link at the bottom of the page pointing to OFF directly — but we won't walk you through it, because the web contribution flow isn't great for mobile users.
🧪
Processing level, told honestly. Every food result now includes its NOVA processing classification — Group 1 (minimally processed), Group 2 (culinary ingredients like oils and sugar), Group 3 (processed foods like cheeses or fresh bread), or Group 4 (ultra-processed formulations). Tap the card to expand: what NOVA means, the specific ingredients that flagged this product, and an evidence pill. We surface it because ultra-processed food is one of the most useful signals in modern nutrition science — but we label it "moderate evidence," not "categorical avoid." NOVA was developed at the University of São Paulo. It classifies products by degree of industrial processing, and there's growing research linking ultra-processed food consumption to chronic disease risk.
📏
Low / Moderate / High badges under nutrition numbers. Sugar, saturated fat, and salt cells now include a small badge answering "is this a lot?" — Low (green), Moderate (cream), or High (warm orange). The classification comes from Open Food Facts, which uses NHS and WHO reference values. Removes the mental math for shoppers who don't know what "1.1g of salt per 100g" actually means. Also: the "Per serving" / "Per 100g" toggle at the top of the nutrition section defaults to Per serving on any product with a defined serving size — matching how Americans read labels. Flip to Per 100g when comparing across products.
📱
KindlyChecked is a web app — but it works better on your home screen. There's no App Store download. You just visit kindlychecked.app and start scanning. But we recommend adding it to your home screen once you've scanned a few products: it's easier to open (no fumbling for the URL), it feels like a real app (no browser chrome), and it helps guard against your browser clearing our stored data over time. After about 5 scans, we'll show a small card on the home screen with platform-specific instructions — tap "Add to Home Screen" on iOS Safari, or use the browser menu on Android. Dismissable if you'd rather not.
💾
Export your data whenever you want. Everything KindlyChecked stores lives on your device — scan history, saved products, allergen preferences, your name. Go to Profile → About → Export my data and you'll get a JSON file with all of it. Save it wherever you'd like: iCloud, Files app, email to yourself, Dropbox — whatever works. Backup insurance against a browser data wipe, a phone reset, or anything else that would otherwise cost you your history. Nothing goes to us. The file is yours.
🌱
A note on organic. We don't subtract points for organic, but we don't add them either. Organic certification means real things: lower pesticide residues, better soil and water practices, often better labor standards. Those reasons might matter a lot to you. But they don't make a tortilla more nutritious than its conventional counterpart. We surface organic certification when we see it — and we leave the choice with you.
🇺🇸
Made for US shoppers. KindlyChecked is currently focused on US grocery data. Scanning works on any barcode globally, but the alternatives we suggest are filtered to US-confirmed products — so they're things you can actually find at your local store. If a category has no US alternatives in the database yet, you'll see an honest "No US picks yet" message. Canada, UK, and EU coming when we can do them justice.
3 The single most important setup

Set your allergens.

Tell us once, and every scan from then on checks automatically. No allergen ever sneaks past you.

Open the Profile tab (the person icon in the bottom nav). Scroll down to "My allergies". You'll see nine common allergens as toggleable pills: gluten, dairy, eggs, nuts, peanuts, soy, fish, shellfish, sesame.

Tap the ones that apply. Each active allergen turns red and shows a checkmark. That's it — you're set forever (or until you change them).

Now every product you scan gets checked against your allergens. If a product contains any of them:

  • A red banner appears at the top
    Before you even see the score. "Contains your allergen — 🥛 Dairy" with a warning icon. Impossible to miss.
  • The score is automatically capped at 20
    No matter how good the rest of the ingredients are, allergen products land in the "Avoid" tier. The math protects you.
  • Better-pick suggestions filter them out too
    When we recommend alternatives, we filter out anything containing your allergens. You'll never get suggested a product you can't eat.
This is not a substitute for reading labels. Open Food Facts data is community-contributed and occasionally incomplete. For severe allergies, always verify the ingredient list yourself.
4 The killer feature

Find better swaps.

When something scores badly, we don't just judge it. We surface alternatives in the same category — same shelf, better answer.

Scan something that scores under 50, and scroll down past the breakdown. You'll see a section called "Better picks for you" with up to four alternatives, ranked by score.

Each alternative card shows the product name, brand, image, and its score in a colored pill. Tap any one to scan it directly — useful when you want to see why the alternative scored higher.

The picks are filtered three ways:

  • Same category as what you scanned
    If you scanned a chocolate spread, we find better chocolate spreads — not unrelated foods. We use the product's category from Open Food Facts.
  • Score 70 or higher
    No marginal swaps. We only suggest alternatives that score at least 10 points higher than what you scanned. If nothing meaningfully better exists, we won't show this section at all rather than waste your time.
  • Allergen-safe
    Anything containing your allergens is filtered out before we even sort. You never get suggested something you can't have.
💡
Pro move: Use this at the grocery store. Scan the thing in your hand, see the alternatives, and check if any of them are on the same shelf. Trader Joe's runs are way more efficient with this.
5 Build your reference library

Save & revisit.

Every scan is automatically saved. Bookmark the keepers. Build a personal database of what's safe in your house.

Two places to find products you've scanned before:

  • Recent scans on the home screen
    The last 4 products you scanned appear at the bottom of the home screen. Tap any to instantly re-scan — useful when you want to compare two products side by side.
  • Saved tab in the bottom nav
    Tap the bookmark icon on any product result to save it permanently. Then access them from the saved tab, sorted by verdict (Excellent / Good / Poor / Avoid). Use this to build a "yes" list and a "never again" list.
  • Share button on every result
    Tap the share icon to send the score to a friend via Messages, WhatsApp, Instagram DMs, whatever. The share text reads "Coca-Cola scored 17/100 (Avoid) on KindlyChecked 🌱" — they get the score and the link to scan their own.
📦
Offline mode: Anything you've scanned in the last 7 days works offline — just open the app, tap the recent scan or saved item, and the cached result appears instantly. Useful when you're at a store with bad signal.
🔒
Where this data lives: Only on your phone. We don't have accounts in v1. Everything (scan history, saved products, allergens) is stored in your browser's local storage. Clear your browser data and it's gone — so don't.
6 Make it part of your life

Make it a habit.

One scan changes nothing. Twenty scans change a household. Here's how people who actually use this app use it.

The pattern that emerges from beta testers — there are five ways KindlyChecked actually fits into someone's week:

🛒

The shopping run

Scan things before you put them in the cart. Especially things you buy on autopilot — cereals, yogurts, bread, soaps. The first time you do a full grocery audit, expect to swap 2–3 items.

🏠

The pantry sweep

One Saturday morning, scan everything in your pantry, fridge, and bathroom. Save the keepers. Use up the bad scores, then don't repurchase. Most rewarding hour you'll spend this month.

🍴

The dinner-party check

Friend brings a dish? Scan the ingredients. Now you know what you're serving guests, what allergens are present, and you can credibly say "this Greek yogurt scores a 92."

🎁

The gift screen

Holiday baskets, beauty samples, baby gifts. Scan before you use. Especially for cosmetics — the worst endocrine disruptors hide in nice-looking gift sets.

📱

The kid scan

Hand the phone to your kid. Let them scan their snacks. Educational, gamified, and they'll start asking questions about food. Don't underestimate this one.

💌

The share-your-find

Found a 95? Found a 12 that you thought was healthy? Hit share. The share message includes the link, so friends who don't have the app yet will install it to see what you're talking about.

🌱
The honest truth: You won't use this for everything, and you shouldn't. The point isn't to obsess over scores — it's to occasionally ask "wait, what's actually in this?" and have a real answer in 4 seconds. Use it when it's useful. Forget it when it's not.

Ready when you are.

You've seen everything. Now actually scan something.

Open KindlyChecked