Store Integration

FourFork's store integration feature connects your meal planning directly to real grocery store products and prices. This powerful feature helps you see actual products available at your local store, compare prices, estimate shopping costs, and make informed purchasing decisions. This guide covers everything you need to know about store integration.

1. What is Store Integration?

Store integration links recipe ingredients to real products available at your local grocery stores.

1.1 Key Features

• Real Product Listings: See actual products from your selected store
• Current Pricing: Up-to-date prices for ingredients
• Package Sizes: Know exactly what size packages to buy
• Product Images: Visual confirmation of products
• Availability Status: Check if items are in stock
• Multiple Options: Compare different brands and sizes
• Cost Estimates: See total shopping cost before you go
• Package Calculations: Know how many packages you need

1.2 Benefits

• Budget Control: Know costs before shopping
• Time Savings: Pre-select products from home
• Smart Shopping: Compare brands and prices
• Accurate Quantities: Buy exactly what you need
• No Guessing: Clear product specifications
• Substitution Help: See alternatives if items unavailable

1.3 Currently Supported Stores

• Kroger: Including all Kroger banner stores
• Kroger Family Stores: Fred Meyer, Ralphs, King Soopers, Smith's, Fry's, QFC, and more
• More Coming Soon: Additional retailers being added regularly

Note: Store availability varies by region. Check if your local store is available.

2. Setting Up Store Integration

2.1 Setting Your Default Store

Configure your preferred store:

1. Click on your profile icon or username
2. Select "Profile Settings" or "Settings"
3. Scroll to the "Default Store" section
4. Click "Select Store" or "Change Store"
5. Enter your ZIP code or city name
6. Browse available stores near you
7. Select your preferred store location
8. Click "Save" or "Set as Default"

2.2 Choosing the Right Store

Select based on:

• Proximity: Store you visit most frequently
• Inventory: Store with best product selection
• Pricing: Store with most competitive prices
• Availability: Store consistently in stock

2.3 Changing Your Store

• Return to Settings at any time
• Select a different store
• Product links update automatically
• Prices reflect new store location
• Useful when traveling or moving

2.4 Multiple Store Support

• Save multiple store locations (coming soon)
• Switch between stores easily
• Compare prices across stores
• Shop at different stores for different items

3. How Store Integration Works

3.1 Ingredient to Product Matching

FourFork intelligently matches ingredients to products:

• Recipe ingredients are linked to store database
• Multiple product options shown per ingredient
• Filtered by your selected store
• Ranked by relevance and popularity
• Updated regularly with new products

3.2 Product Information Displayed

For each linked product:

• Product Name: Brand and specific product
• Image: Visual of actual product
• Price: Current store price
• Unit: Package size (e.g., "16 oz", "1 lb", "6 count")
• Unit Price: Price per ounce, pound, or count
• Packages Needed: How many to buy
• Total Cost: Price × packages needed
• In Stock: Availability status

3.3 Automatic Package Calculation

FourFork calculates how many packages to buy:

3.4 Price Updates

• Prices updated regularly from store APIs
• Reflects current in-store pricing
• Sales and promotions included when available
• Minor variations may occur due to regional pricing

4. Selecting Products in Your Cart

4.1 Viewing Product Options

When you add a recipe to cart:

1. Each ingredient shows available product options
2. Click "Select Product" or the dropdown
3. View all matching products from your store
4. Products sorted by relevance and price

4.2 Comparing Products

Make informed choices by comparing:

• Price: Total cost for needed quantity
• Unit Price: Cost per ounce or item
• Brand: Name brand vs. generic
• Size: Package size options
• Quantity: How many packages needed
• Extras: How much leftover you'll have

4.3 Selecting Your Preferred Product

1. Review available options
2. Click on your preferred product
3. Product is selected for this ingredient
4. Price and package count update
5. Total cart cost recalculates automatically

4.4 Changing Product Selections

• Click on selected product to change
• Choose different option
• Compare before finalizing
• Update anytime before shopping

4.5 Products Without Store Links

If no product is linked:

• Ingredient appears without product options
• Manual shopping required for that item
• Price estimation not available
• May be specialty or produce items
• Database continuously expanding

5. Using Store Products for Budget Planning

5.1 Viewing Total Cart Cost

• Cart displays running total
• Updates as you select products
• Shows cost breakdown by category
• Only includes items with selected products

5.2 Recipe Cost Estimation

See cost per recipe:

• Each recipe shows estimated total cost
• Based on selected products
• Cost per serving calculated
• Compare recipe costs before planning
• Choose budget-friendly options

5.3 Budget-Conscious Shopping

Strategies to save money:

• Compare Generic: Select store brands when available
• Larger Packages: Check if bulk sizes save money per unit
• Unit Price: Compare price per ounce/pound, not just package price
• Sales Items: Look for products marked on sale
• Substitutions: Consider cheaper alternatives with similar uses

5.4 Setting a Shopping Budget

1. Set target budget before planning
2. Add recipes to cart and select products
3. Monitor running total
4. Adjust recipes or products if over budget
5. Remove optional ingredients
6. Substitute expensive items

5.5 Weekly Spending Tracking

• Track estimated vs. actual spending
• See spending trends over time
• Identify areas to cut costs
• Budget more accurately

6. Product Availability and Alternatives

6.1 Stock Status

• Products marked as "In Stock" or "Out of Stock"
• "Limited Stock" warnings when applicable
• Updated regularly but not real-time
• Verify in-store if concerned

6.2 Handling Out-of-Stock Items

When a product is unavailable:

• Product marked with "Out of Stock" badge
• Alternative products suggested automatically
• Select different brand or size
• Consider substitution if appropriate
• Remove from cart if not essential

6.3 Product Substitutions

Smart substitution suggestions:

• Similar products from different brands
• Different package sizes of same product
• Equivalent ingredients (e.g., fresh vs. frozen)
• Recipe compatibility noted

6.4 Seasonal Availability

• Some products only available seasonally
• Fresh produce varies by season
• Holiday items appear at appropriate times
• Plan recipes around available ingredients

7. Shopping with Store Integration

7.1 Pre-Shopping Preparation

1. Plan meals and add to calendar
2. Generate shopping cart from calendar
3. Select products for all ingredients
4. Review total cost and adjust if needed
5. Export or print shopping list with products
6. Save product selections

7.2 In-Store Shopping

Using your product list while shopping:

• Shopping list shows specific products to find
• Product images help identify items
• Package size and count clearly displayed
• Check off items as you add to physical cart
• Quickly see what you still need

7.3 Mobile Shopping Experience

• Access cart on mobile device while shopping
• Real-time list updates
• Check off items on the go
• Quick product image reference
• Easy to verify package sizes

7.4 Adjusting on the Fly

When in-store situations differ:

• Out of Stock: Choose alternative from your product list
• Sale Items: Select sale products to save money
• Different Size: Buy available size and adjust quantity
• Better Deal: Switch to more cost-effective option

7.5 Post-Shopping Review

• Compare estimated vs. actual costs
• Note products that were unavailable
• Update product preferences for next time
• Add purchased items to pantry

8. Advanced Store Features

8.1 Favorite Products

• Mark products as favorites
• Auto-select favorites for ingredients
• Faster cart preparation
• Consistent product choices

8.2 Product History

• Track previously selected products
• Quick re-selection of past choices
• See what worked well before
• Streamlined repeat shopping

8.3 Price Tracking

• Monitor price changes over time
• Get alerts when prices drop
• Identify best times to buy
• Stock up during sales

8.4 Multi-Store Comparison

• Compare prices across different stores (when available)
• Split shopping between stores for best prices
• Factor in convenience vs. savings
• Optimize shopping strategy

8.5 Loyalty Program Integration

• Link store loyalty cards (future feature)
• Apply digital coupons automatically
• Earn rewards points
• See personalized deals

9. Troubleshooting Store Integration

9.1 No Store Near Me

• Check if your chain is under a different name
• Try nearby cities or ZIP codes
• Request your store be added
• More stores being added regularly
• Use FourFork without store integration until available

9.2 Products Not Showing

• Verify store is set in settings
• Refresh the page
• Some ingredients may not have product links yet
• Check internet connection
• Clear browser cache

9.3 Incorrect Prices

• Prices updated regularly but may lag
• Regional variations may exist
• Sales may not be immediately reflected
• Report significant discrepancies
• Always verify prices in-store

9.4 Wrong Products Suggested

• Product matching continuously improving
• Select more appropriate product from options
• Report mismatched products to help improve system
• Use search to find specific products

9.5 Store Changed Products

• Stores regularly update their inventory
• Discontinued products removed automatically
• New products added regularly
• Alternative suggestions provided

10. Best Practices

10.1 Set Up Once, Shop Better

• Take time to set your default store correctly
• Select product preferences for common ingredients
• Mark favorites to speed future shopping
• Initial setup saves time on every future shop

10.2 Review Before Shopping

• Always check total cost before leaving home
• Verify all products selected
• Check for out-of-stock items
• Have backup choices ready

10.3 Be Flexible

• Product availability changes
• Be willing to substitute when needed
• Consider alternatives that are on sale
• Don't be locked into specific products

10.4 Provide Feedback

• Report incorrect product matches
• Suggest better alternatives
• Request missing products be added
• Help improve the system for everyone

10.5 Combine with Other Features

• Use with pantry to only buy what you need
• Use with calendar for weekly planning
• Track spending over time
• Maximize all FourFork features together

Store integration transforms FourFork from a meal planning tool into a complete shopping solution. By connecting recipes to real products and prices, you can plan better, budget accurately, and shop efficiently. Set up your store today to start experiencing smarter grocery shopping! For more information, check out our guides on Shopping Cart Basics and Pantry Management.