The Ingredient Scanner is a powerful tool designed to help users quickly identify potential allergens and ingredients of concern in food products. By leveraging optical character recognition (OCR) technology, this feature allows users to scan ingredient lists and receive immediate feedback on the presence of allergens or other ingredients they wish to avoid.
IMPORTANT
IMPORTANT: This app is an aid only. Always:
- Read ingredient labels carefully
- Follow medical advice
- Contact manufacturer if uncertain
Key Features
- Camera and Gallery Integration: Capture images of ingredient lists directly or import existing photos.
- Image Cropping: Precisely select the area containing the ingredient list for improved accuracy.
- OCR Processing: Utilizes advanced text recognition to extract ingredient information.
- Allergen Highlighting: Automatically highlights potential allergens and ingredients of concern.
- Customizable Allergen List: Users can maintain a personalized list of allergens and ingredients to avoid.
- Result Sharing: Easy sharing of scan results for reference or consultation.
Quick Start
- Open the MAE (Making Allergies Easy) app
- Tap the camera icon at bottom of screen
- Point camera at ingredient list
- Follow the on-screen guides
Taking a Good Scan
- Hold the phone steady
- Ensure good lighting
- Position text parallel to screen
- Include entire ingredient list
Understanding Results
- Red/Yellow text = Potential allergen detected (bold and underlined for emphasis)
- Red in light mode
- Bright yellow in dark mode
- List of allergens checked
- List of other ingredients checked
- Options to rescan or save results
How to Use the Scanner
Step 1: Access the Scanner
- Tap the “Ingredient Scanner” option from the home screen
- The camera will open automatically
Step 2: Capture or Select Image
Option A – Camera:
- Position the ingredient list in the viewfinder
- Tap the capture button
- The image will be taken automatically
Option B – Gallery:
- Tap the gallery icon
- Select a photo containing ingredients
- The app will load your selection
Step 3: Crop the Image
- Use the crop tool to select just the ingredient list
- Pinch to zoom if needed
- Tap “Done” when satisfied
Step 4: Review Results
- OCR processing happens automatically
- Detected allergens appear highlighted (bold, underlined, and colored)
- Red in light mode
- Bright yellow in dark mode
- Scroll to see all detected text
- Use “Rescan” to try again if needed
Privacy and Data Handling
- All image processing occurs locally on the device.
- No ingredient list data is transmitted to external servers.
- Temporary images are securely deleted after processing or when exiting the scanner.
- User preferences and allergen lists are stored using encryption for enhanced security.
- Scan results can be shared but are not stored permanently unless saved by the user.
Tips for Best Results
Camera Tips
- Use good lighting (natural light works best)
- Hold phone parallel to ingredient list
- Avoid shadows and glare
- Focus on text clarity over image quality
Cropping Tips
- Include only the ingredient list
- Remove marketing text and graphics
- Ensure all ingredients are visible
- Leave some margin around text
Understanding Detection
- The scanner uses fuzzy matching to catch misspellings
- Common variations are detected (e.g., “mil” for “milk”)
- Context matters – “milkweed” won’t trigger milk allergy
- Both singular and plural forms are checked
How Allergen Detection Works
Your Personal Safety Profile
MAE creates a personalized safety profile for each user that includes:
- Primary Allergens
- Your main food allergies (e.g., Milk, Peanuts, Tree Nuts)
- Additional Ingredients to Avoid
- Other ingredients you want to avoid (e.g., specific additives, preservatives)
- Safe Ingredient Overrides
- Ingredients that contain an allergen word but are safe for you
- Example: You avoid “milk” but “oat milk” is safe
- Example: You avoid “salt” but “sea salt” is safe
Smart Safe Ingredient Detection
Let’s say you need to avoid salt but sea salt is safe for you:
Ingredient List: "vanilla, sea salt, salt, corn starch"
↓ ↓
SAFE DANGER
MAE is smart enough to know the difference!
- “salt” in “sea salt” → Recognized as safe ingredient
- “salt” by itself → Flagged as allergen
Real-World Examples
Example 1: Milk Allergy with Plant-Based Alternatives
Your Profile:
- Allergen: Milk
- Safe: Oat milk, Coconut milk, Almond milk
Ingredient List: “Water, oat milk, sugar, milk powder, coconut milk”
MAE Detects:
- “oat milk” – SAFE (in your safe list)
- “milk powder” – ALLERGEN (real dairy)
- “coconut milk” – SAFE (in your safe list)
Example 2: Nut Allergies with Specific Exceptions
Your Profile:
- Allergen: Tree nuts
- Safe: Coconut (technically not a tree nut)
Ingredient List: “Almonds, coconut oil, cashews, coconut flakes”
MAE Detects:
- “Almonds” – ALLERGEN
- “coconut oil” – SAFE
- “cashews” – ALLERGEN
- “coconut flakes” – SAFE
Special Detection Features
- Negative Context Recognition
- “Contains no milk” → Won’t flag “milk”
- “Free from peanuts” → Won’t flag “peanuts”
- “0% dairy” → Won’t flag “dairy”
- Brand-Specific Exclusions
- “Milk of magnesia” → Not flagged for milk allergy
- Common non-allergen products are recognized
- Compound Ingredient Understanding
- Milk allergy + “cashew milk” → Not flagged (plant-based)
- Egg allergy + “eggplant” → Not flagged (vegetable)
Allergen Detection Logic Flow
Here’s exactly how MAE decides whether to flag an ingredient:
flowchart TD
A[Found allergen word in text] --> B{Is it in negative context?<br/>like 'free from' or '0%'}
B -->|YES| C[SAFE - Don't flag]
B -->|NO| D{Is it part of an<br/>excluded phrase?<br/>e.g. 'cashew milk' for milk allergy}
D -->|YES| E[SAFE - Don't flag]
D -->|NO| F{Is this word in a<br/>safe ingredient phrase?<br/>e.g. 'salt' in 'sea salt'}
F -->|YES| G[SAFE - Don't flag]
F -->|NO| H[DANGER - Flag as allergen]
style C fill:#90EE90
style E fill:#90EE90
style G fill:#90EE90
style H fill:#FFB6C1
Step-by-Step Example:
Text: “vanilla, sea salt, salt, corn starch”
Your profile: Avoid “salt” but “sea salt” is safe
- Found “salt” at position 13 (in “sea salt”)
- Not in negative context → Continue
- Not excluded → Continue
- “sea salt” IS in safe list → Check position
- This “salt” IS part of “sea salt” → SAFE
- Found “salt” at position 19 (standalone)
- Not in negative context → Continue
- Not excluded → Continue
- Check safe list → Found “sea salt”
- This “salt” is NOT part of “sea salt” → DANGER
Limitations and Disclaimers
- While highly accurate, the Ingredient Scanner is not infallible. Always verify results with the product packaging.
- The app’s allergen detection is based on the information provided by the user and common allergen databases. It may not cover all possible allergens or ingredient names.
- This tool is designed for assistance only and should not replace professional medical advice. Consult with healthcare providers for managing allergies and dietary restrictions.
Feedback and Support
We are committed to continually improving the Ingredient Scanner. Your feedback is invaluable in this process. If you have suggestions, encounter issues, or want to share your experience:
- Use the in-app feedback form located in the Settings menu.
- Email our support team at hello@makingallergieseasy.com.
- Join our user community forum to discuss features and share tips with other users.
Regular updates are released based on user feedback and technological advancements. Keep your app updated to enjoy the latest improvements and features.
Troubleshooting
| Problem | Solution |
|---|---|
| Blurry text | Hold phone steady, improve lighting |
| Missing ingredients | Try recropping to include all text |
| False positives | Check your allergen settings |
| Scanner won’t open | Check camera permissions in settings |
| OCR takes too long | Ensure good internet connection |
| Results seem wrong | Try rescanning with better image |
Scanner Workflow
graph TD
A[Home Screen] -->|Tap Scanner| B[Camera View]
B -->|Capture| C[Image Preview]
B -->|Gallery| D[Photo Selection]
D --> C
C -->|Crop| E[Crop Tool]
E -->|Done| F[OCR Processing]
F -->|Success| G[Results Display]
G -->|Rescan| B
G -->|Share| H[Share Results]
G -->|Done| A
Remember: This tool assists in identifying potential allergens but should not replace careful label reading or medical advice. Always verify results with the actual product packaging.
