> ## Documentation Index
> Fetch the complete documentation index at: https://breederbuddy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# App Not Working

> BreederBuddy page won't load, looks broken, is stuck loading, or a button doesn't work? Quick fixes: refresh, clear cache, try another browser, use BreederBuddy on your phone, and how to report a bug with a screenshot.

# App Not Working

Most "it's broken" moments clear up with a quick refresh or a different browser. Try the steps below in order. If nothing helps, report it to us and we'll take it from there.

***

## The Page Won't Load or Looks Broken

Try these one at a time, checking after each step:

1. **Refresh the page.** Press **F5** on Windows or **Cmd + R** on a Mac. On a phone, pull down on the page or tap the refresh arrow.
2. **Check the address.** Make sure you're on [**app.breederbuddy.com**](https://app.breederbuddy.com).
3. **Check your internet.** Open another website. If that won't load either, the problem is your connection.
4. **Do a hard refresh.** Press **Ctrl + Shift + R** on Windows or **Cmd + Shift + R** on a Mac. This reloads the page without using saved copies.
5. **Try a private window.** Open an incognito or private window and sign in there. If it works, your browser's saved data or an extension is causing the problem. Clear your cache (below) or turn off extensions like ad blockers for breederbuddy.com.
6. **Try a different browser.** If Safari is acting up, try Chrome, or the other way around.

***

## Clearing Your Browser Cache

Clearing the cache makes your browser download a fresh copy of BreederBuddy. You'll need to sign in again afterward.

**Chrome (computer):** click the three dots at the top right → **Delete browsing data** (or **Clear browsing data**) → check **Cookies** and **Cached images and files** → **Delete data**.

**Safari (Mac):** **Safari** menu → **Settings** → **Privacy** → **Manage Website Data** → search "breederbuddy" → **Remove**.

**iPhone or iPad:** **Settings** app → **Safari** → **Clear History and Website Data**.

**Android (Chrome):** three dots → **Settings** → **Privacy and security** → **Delete browsing data**.

Then go back to [**app.breederbuddy.com**](https://app.breederbuddy.com) and sign in.

***

## Which Browsers Work Best

Use an up-to-date version of **Chrome**, **Safari**, **Edge**, or **Firefox**.

**Opened a link from Facebook or Instagram?** Those apps open pages in their own built-in browser, which can't keep you signed in and doesn't allow Google sign-in. BreederBuddy shows a notice asking you to open the page in Safari or Chrome. Follow it, or copy the link into your regular browser.

***

## Using BreederBuddy on Your Phone

BreederBuddy works in your phone's web browser:

1. Open Safari (iPhone) or Chrome (Android).
2. Go to **app.breederbuddy.com** and sign in.
3. Tap the menu button to get to the left menu items.

**Tip:** add it to your home screen so it opens like an app. On iPhone, tap the **Share** button → **Add to Home Screen**. On Android, tap the three dots → **Add to Home screen**.

Everything you do on your phone is the same account you use on your computer, so changes show up on both.

***

## A Button Doesn't Work or Something Won't Save

1. Look for a red message near the button or at the top of the screen. It usually says what's missing, like a required field.
2. Scroll up and down the form. A required field may be empty out of sight.
3. Refresh the page and try once more.
4. Still stuck? Report it (below) and tell us exactly what you clicked.

**Hit a limit?** Some features have monthly or daily limits based on your plan. You can see yours under [**Settings → Usage Limits**](https://app.breederbuddy.com/settings?tab=usage%20limits).

***

## Reporting a Bug

The more we can see, the faster we can fix it. You have two ways to tell us.

### Option 1: Chat with Us (Best for Screenshots)

1. Take a screenshot of the problem.
   * **Windows:** press **Windows + Shift + S** and drag over the area.
   * **Mac:** press **Cmd + Shift + 4** and drag over the area.
   * **iPhone:** press the side button and volume up together.
   * **Android:** press power and volume down together.
2. Click the chat bubble in the bottom right corner of BreederBuddy.
3. Describe what happened and attach your screenshot.

Buddy answers first and brings in Kenny, our founder, whenever needed. You can always ask for a person.

### Option 2: Use the Feedback Page

1. Click [**Feedback**](https://app.breederbuddy.com/feedback) near the bottom of the left menu, under **Support & Feedback**.
2. Click **Report a Bug**.
3. Fill in:
   * **Summary**: a short title, like "Weight chart won't save"
   * **Where does this happen?**: the page or feature (a link is perfect)
   * **What did you expect to happen?**
   * **What actually happened?**: include any error message
   * **How often does it happen?**
4. Click **Send it**.

Your report shows up under **Your requests** on the same page, and we update its status as we work on it. The Feedback form doesn't take attachments, so if a screenshot would help, send it in the chat too.

***

## Common Questions

> **Is BreederBuddy down?**
>
> If [app.breederbuddy.com](https://app.breederbuddy.com) won't load on two different devices or internet connections, message us in the chat or email [support@breederbuddy.com](mailto:support@breederbuddy.com) and we'll check right away.

> **Will I lose my data if I clear my cache?**
>
> No. Your records are saved in your BreederBuddy account, not in your browser. Clearing the cache only signs you out and resets things like remembered filters.

> **Why do my filters reset when I come back to a page?**
>
> BreederBuddy can remember your search, filters, and sorting. Turn on **Remember page filters** in [**Settings → Preferences**](https://app.breederbuddy.com/settings?tab=preferences).

> **Something is broken on my website, not the app.**
>
> Message us in the chat with the page link and a screenshot, or use **Feedback → Request Help** and pick **Website change or fix**.

***

## Still Have Questions?

We're here to help. If something isn't working the way you expect, or you'd like to have a discussion around a certain topic, please reach out to us anytime through the chat in the bottom right corner of your screen.

Thank you.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.