1. Overview

Brew Me Up helps you track your favorite coffee shops, log every coffee you drink, earn achievement badges, discover new places to visit, explore coffee crawl routes, and optionally share your coffee journey with friends.

What Brew Me Up does

  • Track coffee shops — save your favorite locations with photos, addresses, websites, and notes.
  • Log coffee visits — record every drink with the type, tasting notes, rating, price, date, and photo.
  • Earn badges — unlock automatic achievements as you use the app (31 badges total).
  • Discover nearby — find coffee shops, mobile vendors, and bakeries on a map.
  • Plan a coffee crawl — create a route between two points and see the coffee stops along the way.
  • Search & filter — find shops and drinks by name, location, or tasting notes.
  • View insights — charts of your drinking habits and spending by type and time period.
  • Connect with friends — add friends by username, share shop recommendations, and see their coffee achievements.
  • Export your data — download a CSV file of all your shops and drinks.
  • Sync your data — optionally enable cloud sync to keep your data backed up and accessible.

Key features at a glance

FeatureNeeds internet?Needs a permission?Notes
Shops & VisitsNoNoneWorks completely offline; stored locally on your device
BadgesNoNoneUnlock automatically as you use the app
Discover — NearbyYes (for map/business data)Location ("While Using the App")Shows 1–25 nearby results (set in Settings)
Discover — Coffee CrawlYes (for routing)Location (optional — only for "current location" as a start point)Best results on routes under 150 miles
Search (in Shops tab)NoNoneSearches only what's already saved on your device
SocialYes (for syncing with friends)NoneRequires Data Sync to be enabled
Profile — InsightsNoNoneCharts use only your own locally logged data
Export My Data (CSV)NoNoneUses the iOS share sheet to save or send the file
Data SyncYesNone (an email address, not a device permission)Off by default; optional Sign in with Apple upgrade

Device requirements & limitations

Brew Me Up runs on iPhone with iOS 16 or later. The app is not available for iPad or Mac at this time. All data stays on your iPhone by default and syncs optionally to our server if you enable sync. Your data never leaves your device without your explicit choice to turn on cloud sync.

The five main tabs

  • ShopsYour saved coffee shops, with built-in search
  • BadgesYour earned achievements
  • DiscoverFind new coffee shops nearby
  • SocialConnect with friends, share shops
  • ProfileYour profile, settings & insights

2. Getting Started

First Launch

The first time you open Brew Me Up, you'll see a welcome carousel with four informational pages, each explaining a different aspect of the app. These pages introduce Brew Me Up's key features and philosophy.

Onboarding carousel (4 pages)

  1. Page 1: Introduces the app's core concept and privacy philosophy, explaining that your data stays on your device by default and sync is optional.
  2. Page 2: Highlights key features like tracking shops, logging coffee, and earning badges.
  3. Page 3: Introduces the Discover, Coffee Crawl, and Insights features.
  4. Page 4: Explains social features and cloud sync benefits, with a "Get Started" button to continue.
Onboarding carousel, page 1:
Onboarding carousel, page 1: "Private by Design" — privacy philosophy.
Onboarding carousel, page 2:
Onboarding carousel, page 2: "Track Your Coffee Journey" — key features.
Onboarding carousel, page 3:
Onboarding carousel, page 3: "Earn Badges Along the Way" — Discover and Insights.
Onboarding carousel, page 4:
Onboarding carousel, page 4: "Friends Are Optional" — social and sync features.
Brew Me Up Welcome screen on first launch, showing a coffee cup icon, the heading 'Welcome to Brew Me Up', a note that data stays on-device and sync is off by default, an empty Nickname field, and a disabled Get Started button.
The Welcome screen before anything is filled in — the Nickname field is empty and Get Started is disabled.
Welcome screen with the Nickname field filled in as 'DJ', showing the coffee cup icon, the note that data stays on-device with sync off by default, and the enabled Get Started button.
Once a nickname is entered, Get Started becomes active. (Sample data shown for illustration.)

Welcome screen (Name and Email entry)

After the onboarding carousel, you'll see the Welcome screen, which asks for:

  1. Nickname (required) — a display name for your profile. This is shown to friends if you enable social features and sync.
  2. Email (optional) — used only if you later decide to enable cloud sync. Cloud sync is off by default and can be turned on later in Settings if you change your mind.

Tap Get Started to proceed into the main app and see your Shops list. If you've already set a nickname in a previous session, this screen is skipped on launch.

The main app is organized as five tabs across the bottom of your screen. Tap any tab to switch views. The tabs are:

  • Shops — your saved coffee shops and drinks, with a search button
  • Badges — your earned achievements (and badges yet to earn)
  • Discover — find new shops nearby or plan a coffee crawl
  • Social — connect with friends, send and receive shop recommendations
  • Profile — your profile photo, settings, insights charts, and data sync controls
What's new in Revision 6
  • Full Social feature documentation — The Social tab is now fully functional and documented. Connect with friends by username, receive and send friend requests with approve/deny/block controls, view friends' achievements, and share shop recommendations. See Social.
  • Expanded shop management — Detailed guidance on taking and cropping shop photos, and recommending shops directly to friends from the shop detail view. See Taking and cropping photos and Recommending a shop to a friend.
  • Onboarding carousel explained — Clarified the four-page onboarding flow that appears on first launch before the Welcome screen. See First Launch.
  • Enhanced Profile section — Expanded documentation of the Insights charts (with time-range controls for spending) and Settings, including the new friend data deletion option. See Insights and Settings.
  • Data Sync updates — Now includes friend requests, friends, and recommended shops in sync. See Data Sync.
  • Expanded Getting Help — Added support contact information and guidance on reaching the team. See Getting Help.

Quick Start

If you're in a hurry, here's what to do first:

  1. Add your favorite coffee shop to get started.
  2. Log your first coffee visit to earn your first badge.
  3. Explore the Discover tab to find new shops nearby.
  4. Check the Social tab to add friends and share your journey.

A. Shops (Your Coffee Shops)

The Shops tab is your main hub for saving and managing coffee shops, logging visits, and searching your collection. By default, the tab shows an alphabetical list of all your saved shops, with favorited shops sorted to the top.

The Shops tab in its empty state, showing the coffee-themed brewism quote and bottom tab bar.
The Shops tab in its empty state, showing the coffee-themed brewism quote and bottom tab bar.
Your Coffee Shops list showing four saved shops, including Paloma Coffee Co. marked as a favorite with a filled red heart, the search icon and filter icon in the navigation bar, and the current bottom tab bar showing Shops, Badges, Discover, Social, and Profile.
The Shops tab with a few saved coffee shops. The favorited shop (filled heart) sorts to the top; the search icon sits next to the filter icon in the navigation bar.

To search for a specific shop or drink:

  1. Go to the Shops tab.
  2. Tap the magnifying glass icon in the top-right navigation bar. A full-screen search modal will open.
  3. Type your search query in the search field. Results appear as you type.
  4. Use the filter buttons at the top of the search results to narrow by scope:
    • All — search both shops and drinks
    • Shops — search only by shop name, city, or address
    • Drinks — search only by drink name, type, or tasting notes
    • Favorites — search only among your favorite shops
    • Rated — search only drinks you've rated with a thumbs up or down
  5. Tap a result to jump to that shop's detail view or drink entry.
Search results reached from the search icon in the Shops tab, with the All scope selected, the query 'Black Coff' typed in, and four matching Black Coffee drink entries from Paloma Coffee Co. and The Rotunda listed under a Drinks section.
Search results reached from the search icon in the Shops tab's navigation bar, with a query typed in and matching drinks highlighted.
What gets searched

For shops: shop name, city, street address.
For drinks: drink name, drink type, tasting notes, and the associated shop name.

Browse without searching

You don't have to search — just scroll the Shops list or tap a shop to see all its visits. Use the filter icon (to the right of the search icon) in the Shops navigation bar to filter by favorite status.

ii. Adding a shop

To add a new coffee shop:

  1. In the Shops tab, tap the + Add button in the navigation bar.
  2. Fill in the shop's details in the form:
    • Shop Name (required)
    • Address, City, State, Country (required for location context, but only the shop name is required to save)
    • Phone (optional)
    • Website (optional)
    • Notes (optional — add any details you'd like to remember: "Great oat milk," "Quiet atmosphere," etc.)
    • Favorite toggle (optional — turn on to pin this shop to the top of your list)
    • Add Photo (optional — see Taking and cropping photos below)
  3. Tap Save to add the shop to your collection.
The empty 'New Coffee Shop' form, showing Cancel and Save buttons, a Name field under 'Shop Details', Street Address/City/State/Country fields under 'Location', and 'Choose from Library' / 'Take Photo' options under 'Photo'.
The New Coffee Shop form, opened and empty.
Quigley Coffee Company shop detail page with photos and menu images.
Quigley Coffee Company shop detail page with photos and menu images.

iii. Logging a visit

Each time you visit a shop and have a coffee, log a visit:

  1. Open the shop's detail view by tapping it in the Shops list.
  2. Tap the + Add Drink button.
  3. Fill in the drink details:
    • Drink Name (e.g., "Oat Milk Latte")
    • Drink Type (choose from 15 types: Espresso, Americano, Cappuccino, Latte, Macchiato, Mocha, Cortado, Lungo, Ristretto, Cold Brew, Iced Coffee, Frappuccino, Chai, Dirty Chai, Other)
    • Tasting Notes (optional — record flavors, body, or impressions: "Smooth, nutty finish")
    • Rating (optional — thumbs up or down, no middle ground)
    • Date & Time (defaults to now, but you can change it)
    • Price (optional)
    • Photo (optional — tap to add a photo of the drink)
  4. Tap Save to log the visit.
The Log Drink form filled in with example drink name, type, date & time, and Thumbs Up rating.
The Log Drink form filled in with example drink name, type, date & time, and Thumbs Up rating.

Quick-Add: Repeat your last drink. Already had this drink here before? Skip re-typing the details:

  1. Open the shop's detail view.
  2. Tap the Repeat Last Drink button in the top-right of the navigation bar (only shown once the shop has at least one visit logged) — it repeats the shop's most recently logged drink.
  3. A new drink form opens pre-filled with that drink's name and type and today's date; the rating, tasting notes, and photo start blank.
  4. Edit anything you like, then tap Save.

iv. Taking and cropping photos

You can add photos to both shops and individual drinks:

  1. In either the Add Shop form or Add Drink form, tap the Add Photo button or camera icon.
  2. The camera interface opens. Take a photo of the shop exterior, interior, or your drink.
  3. After capturing, a crop screen appears. Adjust the frame to focus on the important details:
    • Drag the frame to reposition the image.
    • Pinch to zoom in or out.
    • Rotate the image if needed.
  4. Tap Save to confirm the crop and attach the photo to the shop or drink.
Photo crop screen showing Cancel, Edit Photo, and Use Photo buttons.
Photo crop screen showing Cancel, Edit Photo, and Use Photo buttons.

v. Recommending a shop to a friend

To recommend a coffee shop to a friend:

  1. Open the shop's detail view by tapping it in the Shops list.
  2. Tap the Recommend button or action menu and select "Recommend to a Friend."
  3. A sheet appears showing your list of active friends.
  4. Select one or more friends to receive the recommendation.
  5. Tap Send. The recommendation is queued and will be sent the next time your app syncs.
  6. Your friend will see the shop appear in their Recommended Shops section in the Social tab, with your name as the recommender.
The Recommend Shop sheet, titled "Recommend 'Quigley Coffee Company' to:", with a friend picker (The Hershman selected with a checkmark, Miranda unselected), and Cancel/Send buttons.
The Recommend Shop sheet, titled "Recommend 'Quigley Coffee Company' to:", with a friend picker (The Hershman selected with a checkmark, Miranda unselected), and Cancel/Send buttons.

B. Badges

Badges are automatic achievements unlocked as you use Brew Me Up. You can't manually earn a badge — they're awarded by the app when you meet their criteria.

Badges tab grid showing earned badges in full color (Cafe Regular, Espresso Explorer, First Coffee, First Coffee Shop, Flavor Hunter, Latte Lover, Lucky Sip, Mocha Moment, Night Owl Brew) alongside locked badges shown desaturated with their unlock threshold, with the current bottom tab bar including Social.
The Badges tab's grid, with earned badges in full color and locked badges desaturated, and the current bottom tab bar (Shops, Badges, Discover, Social, Profile).

There are 31 badges total. Most are tied to specific actions (logging your first espresso, visiting 5 unique shops) or milestones (logging 50 total coffees, visiting shops in 3 different cities). Earned badges display in full color; locked badges appear grayscale.

Visit your Profile to see a summary of your badges, or browse the Badges tab to see the complete list with descriptions of unlock criteria.

C. Discover

The Discover tab has two features: find nearby shops on a map, or plan a themed route between two locations (a "coffee crawl") to see stops along the way.

i. Nearby Shops

To find coffee shops and vendors near you:

  1. Go to the Discover tab and tap Nearby.
  2. Grant location permission when prompted (or enable it later in Settings under "Nearby Shops"). The app shows 1–25 results around your current location by default.
  3. The map displays nearby shops as pins. Scroll the results list below the map to see each location's name, address, and distance.
  4. Tap a result to open its detail view, or tap the + Save to My Shops button to add it to your Shops collection without leaving Discover.
System location-permission dialog over the Discover tab.
System location-permission dialog over the Discover tab.

Adjust your search range: Use the filter chip labeled "Near Me" and change the search radius in Settings under "Nearby Shops — Show Results Within [X] miles" (default: 1 mile).

Filter by type: Use the filter chips at the top to show only coffee shops, mobile vendors, bakeries, or a combination. Only some regions include all three types.

Nearby shops map showing a coffee shop pin selected with callout and action buttons.
Nearby shops map showing a coffee shop pin selected with callout and action buttons.

ii. Coffee Crawl

Plan a themed route through multiple coffee stops:

  1. Go to the Discover tab and tap Coffee Crawl.
  2. Enter a destination address (required — where you want to end up).
  3. The app defaults to your current location as the start point. If you want a different start point, toggle off "Use Current Location" and enter a custom address.
  4. Tap Plan Route.
  5. The app shows a map with your planned route (brown line) and coffee stops along the way marked with icons (cup for shops, truck for mobile vendors, cake for bakeries).
  6. Adjust your route with these controls:
    • Max Detour: How far out of the way you'll go to visit stops. Options: 0.5, 1, 2, or 5 miles.
    • Show Up To: How many stops you want to see. Options: 5, 10, 15, or 20 stops.
    • Venue Filters: Toggle coffee shops, mobile vendors, and bakeries on/off.
  7. Tap a stop to see its detail, or swipe to remove stops you don't want.
  8. Tap the Open in Maps button at the bottom to open your route in Apple Maps with all stops as waypoints (limited to 9 waypoints at a time due to Apple Maps constraints).
Completed Coffee Crawl from San Francisco to San Jose, showing the driving route as a brown line on the map and a stops list with Bluestone Lane and Fresh Brew Coffee cards, each showing distance along the route and off-route distance.
A planned Coffee Crawl, showing the route map and the coffee stops list sorted by distance along the route.

Best results: Coffee Crawl works best on routes under 150 miles. Longer routes may take longer to calculate and may return fewer stops.

D. Social

The Social tab lets you connect with friends, share shop recommendations, view friends' coffee achievements, and enjoy the coffee journey together. All social features require Data Sync to be enabled.

i. Setting up your username

When you first use Social features (or enable sync), you'll be prompted to create a @username. This is your unique identifier for friends to find and add you.

  1. Go to the Profile tab and tap Settings.
  2. Look for the Username field and tap to create or edit your @username.
  3. Choose a unique name (just letters, numbers, and underscores — no spaces). Examples: @sarah_coffee, @cortadojon, @thebrewtaster.
  4. Tap Save.

Your username is displayed in your Profile and is visible to friends who accept your friend request. You can change it anytime in Settings.

ii. Sending friend requests

To add a friend:

  1. Go to the Social tab.
  2. In the Friends section, tap the + button in the toolbar (or tap "Add Friend" in the header).
  3. An "Add Friend" sheet appears. Type your friend's @username in the search field (e.g., "@sarah_coffee").
  4. Tap Send Request.
  5. A confirmation message shows: "Request sent to [@username]. It will reach them on their next sync."

Your friend will see your request in their Incoming Requests section on the Social tab. They can approve, deny, or block you.

iii. Managing incoming friend requests

When someone sends you a friend request, it appears in the Incoming Requests section of your Social tab.

  1. Go to the Social tab and look for the Incoming Requests section at the top. A badge shows the count of pending requests.
  2. Each request shows the sender's @username.
  3. For each request, you have three options:
    • Approve — accept the friend request. They'll become an active friend after the next sync.
    • Deny — reject the request without blocking. You can still receive future requests from this person.
    • Block — permanently block this user from ever sending you a friend request again. This action is irreversible. See Blocking users for more details.
Screenshot needed Social tab -- Incoming Requests section with Approve/Deny/Block buttons visible on a request card
Incoming friend requests (placeholder -- capture needed)

iv. Tracking outgoing requests

To see the status of friend requests you've sent:

  1. Go to the Social tab.
  2. Tap the Sent button (paperplane icon) in the toolbar at the top right.
  3. A list of your outgoing requests appears, showing:
    • The recipient's @username.
    • The current status: "Will send on next sync," "Sent — waiting for response," "Accepted," or "Declined."
  4. If a request hasn't been sent yet (still local), you can swipe to delete it before it syncs.

v. Your friends list

Once you and a friend have approved each other's requests, they appear in your Friends section on the Social tab.

  1. Go to the Social tab and scroll to the Friends section.
  2. Your active friends are listed with:
    • Their @username.
    • A custom nickname (optional — you can set this to whatever you like for your own reference).
    • Their latest earned badge (if any) and total badge count.
    • Optional: Home Shop and Last Visited Shop names (only shown if your friend has opted in to share this context in their settings).
  3. Tap a friend to open their detail view and customize your local label for them.
  4. Swipe a friend to see the Remove option, which ends the friendship (you'll no longer see their info, and they won't see yours).
The Social tab, showing the Friends section with two friends (The Hershman @hershmaster, with badges and a last-visited shop; Miranda @esposa, with no badges yet). The Incoming Requests and Recommended Shops sections above are shown in their empty states.
The Social tab, showing the Friends section with two friends (The Hershman @hershmaster, with badges and a last-visited shop; Miranda @esposa, with no badges yet). The Incoming Requests and Recommended Shops sections above are shown in their empty states.

vi. Friend details and customization

Tap a friend's name to open their detail view:

  1. At the top, you'll see their @username (read-only) and a custom nickname field. Edit the nickname to set a local label (e.g., "Sarah — Portland office").
  2. Below that, a Badges section shows:
    • Their total earned badge count.
    • Their most recent badge (with the date earned).
  3. An optional Coffee Context section (if they've shared it) shows:
    • Their Home Coffee Shop (if set).
    • Their Last Visited Shop and the date of that visit.
  4. At the bottom, two action buttons:
    • Remove Friend — ends the friendship cleanly. You'll no longer see their info.
    • Block — permanently blocks this friend from sending you future requests. See Blocking users for details.
Screenshot needed Friend detail view -- nickname field, badge summary, optional Coffee Context, Remove Friend / Block buttons
Friend details and customization (placeholder -- capture needed)

vii. Blocking users

Blocking a user prevents them from ever sending you a friend request again. This is different from removing or denying a request.

  1. You can block a user in two places:
    • From an Incoming Request — tap the Block button instead of Approve/Deny.
    • From a Friend's Detail View — tap the Block button at the bottom.
  2. A confirmation dialog will appear stating: "Block also permanently prevents [@username] from ever sending you a friend request again. This can't be undone."
  3. Tap Confirm to block. The user will be removed from your friends list and blocked permanently.

When friends recommend shops to you, they appear in the Recommended Shops section of your Social tab.

  1. Go to the Social tab and scroll to the Recommended Shops section.
  2. Each recommendation shows:
    • The shop's name, address, and city/state.
    • The name of the friend who recommended it.
    • A Save to My Shops button.
  3. Tap the shop card to see more details, or tap Save to My Shops to add it directly to your Shops collection.
  4. Once saved, the recommendation is marked as "saved" and you'll see it in your Shops list going forward. Recommendations you haven't saved yet remain in the Recommended Shops section for your reference.
Screenshot needed Social tab -- Recommended Shops section showing a shop card with Save to My Shops button
Receiving shop recommendations (placeholder -- capture needed)

E. Profile

The Profile tab shows

Profile section showing a profile photo, the nickname DJ, a Home Coffee Shop card for Paloma Coffee Co. with its address and visit stats, and a Badges Earned card showing 7 of 31 badges with the most recent badge, Mocha Moment.
The Profile section, showing the Home Coffee Shop card and the Badges Earned summary, and the current bottom tab bar including Social.
your personal information, badges earned, insights about your coffee habits, and access to settings.

i. Home Coffee Shop

Designate a favorite shop as your "home" coffee shop for a quick reference and to help unlock certain badges:

  1. Go to the Profile tab.
  2. Tap the Home Coffee Shop card (shows "Not Set" if you haven't chosen one yet).
  3. A list of your saved shops appears. Tap the one you visit most frequently.
  4. That shop is now your Home Coffee Shop and displays at the top of your Profile with a photo and visit count.

Your Home Coffee Shop is displayed to friends when social features are enabled, so they know where you like to hang out.

ii. Insights

The Insights section shows visual charts of your coffee habits and spending:

  1. Scroll down on the Profile tab to see two charts:
    • Drinks by Type (pie chart): Shows the breakdown of your logged drinks by type (Espresso, Latte, Cappuccino, etc.). Tap a slice to see the count.
    • Spending (bar chart): Shows your total spending over time, with a time-range selector at the top. Options: Week, Month, Year, or All Time.
  2. All data in Insights is calculated from your local data only — nothing is ever sent to us for analytics. Even with sync enabled, your charts are yours alone.
Insights view for the Week time span, showing a pie chart of drinks by type (Black Coffee, Latte, Cortado, and Mocha slices) with a color-coded legend of all 15 drink types below it.
The Insights view's "Drinks by Type" pie chart and legend.

iii. Settings

The Settings section is where you manage your profile, enable sync, and control social & data options:

  1. Tap Settings on your Profile tab to open the settings panel. You'll see:
    • Nickname: Your display name (shown on your profile and to friends). Edit anytime.
    • Email: Your email address for account recovery and sync. Optional unless you enable sync.
    • Home City/State/Country: Your location (optional, used to unlock the "Local Legend" badge for 10 shops in your home city).
    • Nearby Shops — Show Results Within [X] miles: Distance radius for Discover > Nearby. Default: 1 mile. Options: 0.5, 1, 2, 5, 10 miles.
    • Username: Your @username for social features (see Setting up your username).
    • Allow Location While Using App: Permission toggle for location access (needed for Discover > Nearby and optional for Coffee Crawl).
  2. Top of the Settings screen showing Personal Info with the nickname DJ and an empty Email field, Home Location (Orlando, FL, United States), the Your Home Coffee Shop picker set to Paloma Coffee Co., and the Nearby Coffee shop-count control.
    Settings, showing Personal Info (with Email left blank until sync is set up), Home Location, and the Your Home Coffee Shop picker.
  3. Scroll down to the Data & Sync section:
    • Sync my data: Turn on to enable cloud backup. Your shops, drinks, badges, and social data (friends, requests, recommendations) are encrypted and synced to our server. Off by default.
    • Sign in with Apple: Link your Apple ID to upgrade to secure Sign in with Apple-based sync (recommended for security). Your email is verified through Apple and never shared with us.
    • Delete All Friend Data: A red destructive button that clears all your friends, incoming/outgoing requests, and recommendations in one action. This is permanent and cannot be undone. Use only if you want to start fresh socially.
    • Screenshot needed Settings -- Delete All Friend Data confirmation dialog
      Delete All Friend Data confirmation (placeholder -- capture needed)
  4. Below that, you'll find:
    • Export My Data: Download a CSV file of all your shops and drinks for your records or import into another app.
    • Support / Help: Link to the support page and the User Guide.
    • Follow Us: Links to the Brew Me Up social media accounts and website.
Bottom of the Settings screen showing About (app name and version 1.0 build 229), Your Data (Export My Data), Technical Support (support email, website, and User Guide links), the Follow Us section (X and Instagram handles), and Legal (Disclaimer).
The bottom of Settings, showing About, Your Data, Technical Support, Follow Us, and Legal.

4. Data Sync

What is sync?

Sync is Brew Me Up's optional cloud backup. By default, all your data stays on your iPhone and never leaves your device. When you enable sync, your shops, drinks, badges, friends, friend requests, and recommended shops are uploaded to our secure server. Sync allows you to:

  • Back up your data — if you lose or replace your phone, reinstall the app, your data is restored.
  • Use social features — friends, recommendations, and request syncing all require sync to be enabled.
  • Know your data is safe — we do not sell, share, or analyze your data. Encryption is end-to-end between your device and our server.

Enabling cloud sync

  1. Go to the Profile tab and tap Settings.
  2. Scroll to the Data & Sync section and toggle Sync my data to on.
  3. You'll be asked for an email address. Enter a valid email (you'll use this for account recovery if needed).
  4. A first sync begins automatically. You'll see a sync status indicator. Once complete, your data is backed up.
  5. From then on, every time you open the app, make changes, or explicitly sync, your data is uploaded to the server automatically.
Sync section of Settings with the 'Sync my data' toggle switched on and an 'Active — syncing on each launch' status message, plus explanatory text noting sync is off by default and that your Apple ID keeps your data recoverable after a reinstall.
The Sync section of Settings, with the "Sync my data" toggle on and the "Active — syncing on each launch" status.

Automatic sync

Once sync is enabled, the app syncs in the background:

  • When you open the app.
  • After you save a shop, drink, or make social changes (friend request, recommendation, etc.).
  • Periodically every few minutes if the app is running in the foreground.

You'll see a brief sync indicator if a sync is in progress. You don't need to do anything — it happens automatically.

Disabling sync

To turn off sync:

  1. Go to the Profile tab and tap Settings.
  2. Scroll to Data & Sync and toggle Sync my data to off.
  3. A confirmation dialog appears stating that your data will no longer be backed up. Tap Confirm to proceed.
  4. Your data remains on your device, but it's no longer synced to the server. If you reinstall the app or get a new phone, your data will not be recovered.
  5. Important: If you had friends or social connections, they will be marked as "out of sync" on their end until you both re-enable sync.

Troubleshooting sync

Sync won't start or keeps failing:

  • Check that you have an internet connection (WiFi or cellular).
  • Force-close the app (swipe up from the bottom on iPhone, or in the App Switcher) and reopen it.
  • Make sure you're signed in with a valid email address in Settings. If you're unsure, toggle Sync off and back on to re-enter it.
  • If sync still fails, check your email for a message from Brew Me Up asking you to verify your address.

Friend data included in sync:

Sync now includes your friend requests (incoming and outgoing), active friends list, and shop recommendations. All of these are encrypted and stored securely on our server alongside your shops and drinks.

5. Glossary

Badge
An automatic achievement you unlock by meeting certain criteria in Brew Me Up (e.g., logging your first coffee, visiting 5 unique shops, earning 10 total badges). There are 31 unique badges. They're purely for fun and bragging rights.
Brewism
A witty, coffee-themed saying or joke displayed on the empty Shops screen when you have no shops saved yet. Different sayings appear each time you open the app with an empty collection.
Coffee Crawl
A feature in the Discover tab that plans a route between two locations and shows coffee shops, mobile vendors, and bakeries along the way. You can adjust the number of stops and how far off-route you're willing to go.
Drink Type
The category of coffee or beverage you logged (Espresso, Latte, Cappuccino, Mocha, Cold Brew, Chai, etc.). Choose from 15 predefined types when logging a visit.
Favorite
A toggle on any shop in your collection. Favorite shops sort to the top of the Shops list and are a quick filter in the Search scopes.
Home Coffee Shop
A shop you designate as your favorite or most-visited location. It displays on your Profile and is visible to friends if social features are enabled. Used to unlock the "Local Legend" badge.
Medal/Ribbon Icon
The app icon for the Badges tab. It resembles a stylized ribbon or medal awarded for achievements.
Max Detour
In the Coffee Crawl feature, how far off your direct route you're willing to travel to visit coffee stops. Options: 0.5, 1, 2, or 5 miles.
Nearby
A feature in the Discover tab that shows coffee shops, mobile vendors, and bakeries on a map near your current location. Requires location permission.
Rating
A thumbs-up or thumbs-down rating you can add to any drink you log. No middle ground — it's either a keeper or not. Rated drinks can be filtered in Search.
Sync
Optional cloud backup for your Brew Me Up data. When enabled, your shops, drinks, badges, friends, and social data are uploaded to our encrypted server and backed up. Off by default.
Tasting Notes
Optional text you add when logging a drink, describing flavors, body, aroma, or other impressions (e.g., "Nutty and smooth, great with milk"). Searchable and stored with the drink entry.
Username
Your unique @identifier for social features (e.g., @sarah_coffee). Friends use your username to send you friend requests.

6. Troubleshooting

Start here if something's not working as expected.

General issues

The app keeps crashing or freezing.

Try:

  1. Force-close the app by swiping up from the Home Indicator (or use the App Switcher).
  2. Reopen Brew Me Up.
  3. If it still freezes, restart your iPhone (power off and back on).
  4. Make sure you're running the latest version of Brew Me Up from the App Store.
I see an error message I don't understand.

Try:

  1. Note down the exact error message (screenshot if possible).
  2. Check FAQ and Getting Help to see if it's a known issue.
  3. If you can't find an answer, contact support (see Getting Help).

Photos & camera

The camera won't open when I try to add a photo.

Try:

  1. Check that you've granted Brew Me Up camera permission. Go to iPhone Settings > Brew Me Up > Camera and toggle on.
  2. Close Brew Me Up and reopen it.
  3. If the camera still won't open, restart your iPhone.
Photos are blurry or pixelated.

Try:

  1. Make sure your iPhone's camera lens is clean (wipe with a soft cloth).
  2. When taking a photo, tap the screen to focus on the subject before snapping.
  3. Ensure you have adequate lighting — the camera performs better in well-lit environments.
  4. Use the crop tool to zoom in on the most important part of the image and improve apparent sharpness.

Location & Discovery

Nearby Shops isn't showing any results, or very few.

Try:

  1. Ensure you've granted location permission. Go to iPhone Settings > Brew Me Up > Location and set to "While Using the App."
  2. Make sure you have an internet connection (WiFi or cellular) — Nearby requires map data.
  3. Try widening your search radius. Go to Profile > Settings and increase the "Nearby Shops — Show Results Within [X] miles" setting.
  4. Try searching in a different area with more coffee businesses (urban areas show more results than rural areas).
Coffee Crawl is taking a very long time to load, or is timing out.

Try:

  1. Check that you have a strong internet connection.
  2. Try a shorter route (Coffee Crawl works best on routes under 150 miles).
  3. Reduce the "Show Up To" number of stops (try 5 instead of 15).
  4. Force-close Brew Me Up and try again.

Sync

Sync keeps failing or says "Sync error".

Try:

  1. Check your internet connection (WiFi or cellular).
  2. Go to Profile > Settings and verify your email address is correct and verified.
  3. Force-close Brew Me Up and reopen it to trigger a fresh sync attempt.
  4. If the error persists, toggle Sync off and back on to re-authenticate.
My friends' data isn't showing in the Social tab.

Try:

  1. Make sure Data Sync is enabled in Profile > Settings.
  2. Force-close the app and reopen it to trigger a sync.
  3. Check that your friend has also accepted your friend request — requests must be mutual before they appear in your Friends list.
  4. If your friend disabled sync, you won't see their updated data until they re-enable it.

Performance

The app is slow or uses a lot of storage.

Try:

  1. Restart your iPhone.
  2. If you've logged hundreds of drinks and have many large photos, the app may use more storage. Consider deleting very old entries you no longer need via the Shops detail view.
  3. Check your iPhone's available storage (iPhone Settings > General > iPhone Storage). If you're low on space, Brew Me Up may perform slower. Free up space by removing other apps or photos.

Settings & Preferences

I don't remember my email or can't access the account recovery link.

Try:

  1. Check your iPhone Settings > Brew Me Up > iCloud to see if you're signed in with an iCloud account. That email is often used for Brew Me Up sync.
  2. Disable Sync, then re-enable it and carefully enter your email again. Take a screenshot of what you enter to remember it.
  3. Contact support (see Getting Help) with proof of ownership (your nickname or shops in the app) and we can help recover your account.

7. FAQ

Data & Export

Can I export my data?

Yes. Go to Profile > Settings and tap Export My Data. The app generates a CSV file with all your shops and drinks, which you can email, save to iCloud, or send to another app. Your data is yours — we make it easy to take it with you.

What data does Brew Me Up collect?

Brew Me Up only collects what you add: shops you save, drinks you log, ratings, notes, and photos. We do not track your location in the background, do not collect analytics on your behavior, and do not sell your data. Your data is stored locally on your iPhone by default. If you enable sync, it's encrypted and stored on our server solely for backup and social features.

Sync & Account

Is my data private?

Yes. Your data is encrypted end-to-end between your device and our server. We do not read, analyze, or share your data with third parties. Your coffee preferences, shops, and visits are for your eyes only (unless you explicitly share them with friends via social features).

Can I sync across multiple devices?

Not yet. Brew Me Up is currently iPhone-only, and sync works on a per-device basis. If you get a new iPhone, you can restore your data by signing in with the same email address you used for sync. We may add multi-device support in the future.

What happens if I disable sync?

Your local data remains on your iPhone, but it's no longer backed up to the server. If you reinstall the app or get a new phone, your data will not be recovered. Social features will be paused for your friends until you re-enable sync.

Features & Limits

Why can't I set a rating of 3 or 4 stars?

Brew Me Up uses a simple thumbs-up or thumbs-down rating system, not a 5-star scale. We found this makes it quicker to decide if you'd order that drink again, without the ambiguity of 3- and 4-star ratings. You can always write tasting notes to capture nuance.

Can I share my profile with others?

You can add friends via the Social tab and they'll see your badges and (optionally) your Home Shop and last visited shop. You cannot publicly share a link to your profile outside of the app yet, but you can use the export feature to share a CSV of your data manually.

How many shops and drinks can I save?

There's no hard limit, but performance may slow if you're storing hundreds of high-resolution photos. We recommend keeping your device storage healthy by periodically removing old entries you no longer reference.

Deletion & Recovery

Can I delete a shop or drink?

Yes. Open the shop's detail view, tap the three-dot menu or edit button, and select Delete. A confirmation dialog will appear. Once deleted, it cannot be recovered unless you have a backup from sync.

If I delete a shop, are its visits deleted too?

Yes. Deleting a shop removes all associated visits and drinks. Make sure you export your data first if you want to keep a record.

Can I recover deleted data?

If you have sync enabled, deleted data may be recoverable from your backup if you act quickly (contact support). If sync is off, deleted data is permanently removed from your device. This is why we recommend enabling sync and regularly exporting your data if it's important to you.

Support

How do I contact support?

See Getting Help for support contact options and resource links.

8. Getting Help

Before contacting support

Check these resources first — your issue may already be answered:

  • Troubleshooting — step-by-step fixes for common issues.
  • FAQ — answers to frequent questions about data, sync, features, and deletion.
  • Glossary — clear definitions of app-specific terms if something is unclear.

How to get support

If you can't find an answer in the guide above, you can reach out to us:

  • Email: We'll respond to support requests within 2–3 business days. Check Profile > Settings > Support for the exact email address, or use the in-app support link.
  • Website: Visit our website for FAQs, announcements, and app links (check Profile > Settings > Follow Us or Support).
  • User Guide: This guide is also available online and in the app. If you get stuck, re-reading a section often clarifies confusion.

Helpful information to include when contacting us

To help us resolve your issue faster, please include:

  • A clear description of what happened and what you expected.
  • The name of the feature or tab where the issue occurred (e.g., "Social tab, friend request section").
  • Your iPhone model and iOS version (iPhone Settings > General > About).
  • Whether you have sync enabled, and if the issue is related to sync or social features.
  • A screenshot of the error or unexpected behavior (if possible).

Response expectations

We aim to respond to all support inquiries within 2–3 business days. For account recovery or sync issues, responses may take a bit longer as we verify your identity. Thank you for your patience.