Building a Meal Finder App for My Wife: Navigating the Hidden Challenge of Potato Starch in "Gluten-Free" Foods
Because 'Gluten-Free' Apparently Means 'We Just Replaced It With the Other Thing You're Allergic To'"
When food brands and restaurants slap a “gluten-free” label on their products, many people with celiac disease or gluten sensitivity breathe a sigh of relief. But for my wife—and thousands of others like her—that label only tells half the story. She’s not just allergic to gluten; she’s also allergic to potato starch, one of the most common substitutes used in gluten-free products. And that’s where the real problem begins.
The Hidden Problem with “Gluten-Free” Foods
Here’s the frustrating reality: when food manufacturers remove gluten from their products, they need to replace it with something to maintain texture, binding, and structure. Nine times out of ten, that something is potato starch. Walk down any gluten-free aisle, and you’ll find it everywhere—in breads, crackers, pasta, baked goods, even sauces and condiments.
For someone with a dual allergy to both gluten and potato starch, grocery shopping becomes an exhausting detective mission. Every label must be scrutinized. Every ingredient list must be memorized. And even then, it’s easy to miss products that could be safe alternatives simply because they’re buried among hundreds of unsuitable options.
After watching my wife struggle with this challenge week after week, I decided to do something about it. I built a Python-based Streamlit app called the Gluten & Potato Starch Free Meal Finder—a searchable database that makes it easy to find truly safe food options and plan meals with confidence.
What Is the Meal Finder App?
The Gluten & Potato Starch Free Meal Finder is a web-based application that helps users search through a curated database of foods that are verified to be free of both gluten and potato starch. The app features:
A comprehensive database of 48 common products across 12 food categories (dairy, proteins, grains, snacks, condiments, pasta, baking ingredients, and more)
Smart filtering options to search by brand, category, certifications (like Organic or Non-GMO), and to exclude specific allergens
Meal planning tools with quick filters for breakfast, lunch, dinner, snacks, or baking/cooking needs
Complete product details including full ingredients lists, allergen statements, and certification logos
Built-in meal ideas to inspire quick and safe meal planning
The app is built with Python and Streamlit, making it lightweight, fast, and easy to run on any computer with minimal technical knowledge.
Why This App Is Valuable
1. It Saves Time and Reduces Stress
Instead of spending hours in the grocery store reading every single label, users can quickly search the database before they shop. They can filter by meal type, exclude additional allergens, and even search for products with specific certifications. What used to take an hour can now be done in minutes.
2. It Prevents Accidental Exposure
When you’re managing food allergies, mistakes can have serious consequences. The app provides verified information in one place, reducing the risk of accidentally purchasing a product that contains hidden potato starch or gluten.
3. It Empowers Meal Planning
The app doesn’t just list products—it helps you plan actual meals. The built-in meal suggestions show how to combine products into real breakfast, lunch, and dinner ideas. This turns a database into a practical meal planning tool.
4. It’s Customizable and Expandable
Because the app is built with a simple JSON database structure, users can easily add their own discovered products. As more safe foods are identified, the database grows and becomes even more useful.
Requirements
To run the Gluten & Potato Starch Free Meal Finder app, you’ll need:
Software Requirements
Python 3.8 or higher (Download from python.org)
pip (Python’s package installer, included with Python)
Python Package Requirements
Streamlit (version 1.28.0 or higher) - The web framework that powers the app
Pandas (version 2.0.0 or higher) - For data handling and manipulation
These dependencies are listed in the included requirements.txt file and can be installed with a single command.
How to Implement the App
Setting up the app is straightforward and requires just a few steps:
Step 1: Download the Files
You’ll need four files to run the app:
meal_finder_app.py - The main application code
gluten_potato_starch_free_foods.json - The food database
requirements.txt - List of Python dependencies
README.md - Documentation and instructions
Place all four files in the same directory on your computer.
Step 2: Install Dependencies
Open your terminal or command prompt, navigate to the directory where you saved the files, and run:
pip install -r requirements.txtThis command installs Streamlit and Pandas automatically. The installation typically takes less than a minute.
Step 3: Verify the Setup
Make sure all files are in the same folder. The app specifically looks for the gluten_potato_starch_free_foods.json file in the same directory as the Python script, so keep them together.
How to Run the App
Once everything is installed, running the app is incredibly simple:
Launch the App
In your terminal or command prompt, navigate to the app directory and run:
streamlit run meal_finder_app.pyAccess the Interface
Streamlit will automatically open the app in your default web browser. If it doesn’t open automatically, look for a message in the terminal that says something like:
Local URL: http://localhost:8501
Copy that URL and paste it into your browser.
Using the App
Once the app is running, you’ll see:
Left Sidebar:
Category filters to narrow down food types
Brand search to find specific manufacturers
Certification filters (Organic, Non-GMO, etc.)
Allergen exclusion checkboxes
Meal type selector (Breakfast, Lunch, Dinner, etc.)
Main Display:
Tabs organized by food category
Expandable product cards showing:
Complete ingredients list
Allergen statements
Certifications and badges
Verification status for gluten-free and potato starch-free
Bottom Section:
Quick meal ideas for breakfast, lunch, and dinner
Simple combinations using products in the database
Stopping the App
When you’re done, simply press Ctrl+C in the terminal to stop the Streamlit server.
The Technical Architecture
For those interested in the technical details, here’s how the app is structured:
Data Layer
The food database is stored as a JSON file with a hierarchical structure:
Categories contain multiple food items
Each item includes brand, product name, ingredients, allergen info, and certifications
Metadata tracks version, update date, and total counts
Application Layer
The Streamlit app uses Python to:
Load and cache the JSON data for fast performance
Provide reactive filtering based on user selections
Dynamically generate tabs and expandable cards
Apply complex filtering logic (category, brand, certification, allergen exclusions)
User Interface Layer
Streamlit’s component-based architecture creates:
A responsive sidebar for filters
Tabbed navigation for categories
Expandable cards for detailed product information
Real-time updates as filters change
Expanding the Database
One of the best features of this app is how easy it is to add new products. The JSON structure is simple and human-readable:
json
{
“brand”: “Brand Name”,
“product_name”: “Product Name”,
“ingredients”: [”ingredient1”, “ingredient2”],
“allergen_statement”: “Contains: XYZ”,
“certifications”: [”Gluten-Free”, “Organic”],
“gluten_free”: true,
“potato_starch_free”: true
}Simply open the JSON file in any text editor, add a new product following this format, save the file, and refresh the app. Your new product will appear immediately.
Real-World Impact
Since building this app, meal planning in our household has become dramatically easier. My wife can now:
Shop with confidence knowing exactly which products are safe
Discover new options she might have missed by browsing filtered results
Plan varied meals using the meal ideas feature
Save mental energy by not having to memorize which brands are safe
The app has transformed what was once a source of daily stress into a manageable, even empowering, part of our routine.
Looking Forward
This app started as a personal project to help my wife, but I’m sharing it because I know there are countless others facing the same challenge. Whether you’re dealing with gluten and potato starch allergies, or any other combination of dietary restrictions, the principles behind this app can be adapted to your needs.
The code is straightforward enough that anyone with basic Python knowledge can modify it. The database structure is simple enough that non-programmers can add products. And Streamlit makes it easy enough to run that you don’t need to be a developer to use it.
Getting Started
If you or someone you know is struggling to find foods that are truly free of both gluten and potato starch, I encourage you to download the app and give it a try. The setup takes less than five minutes, and it could save hours of frustration every week.
All the files are provided ready to use:
The complete application code
A starter database with 48 verified products
Full documentation and instructions
A requirements file for easy installation
Food allergies are challenging enough without having to navigate misleading labels and hidden ingredients. This app is my small contribution to making that challenge a little bit easier.
About the Author: I’m a developer and author who built this tool out of necessity when traditional “gluten-free” options failed to meet my wife’s dietary needs. If this app helps even one person find safe meal options more easily, it was worth building.
Technical Details:
Built with Python 3.8+ and Streamlit 1.28.0+
Uses JSON for data storage
Open structure for easy customization
No server or database required
• Runs locally on your machine
Download: All files are available for immediate use, including the application code, database, requirements, and documentation.
https://github.com/rod-trent/JunkDrawer/tree/main/Meal%20Finder



