Help Center

1. Download the app from App Store or Google Play.
2. You'll see a 4-page intro slideshow on first launch.
3. Tap "Get Started" to reach the sign-in screen.
4. Sign up with email + password or Google / Apple.
5. Choose your role: Farmer or Veterinarian.
6. If you chose Farmer, your farm opens automatically — start adding animals.

Farmer: You manage your own farm. Animals, milk, finance, feed — everything is yours. You can invite team members or veterinarians.

Veterinarian: You consult for farms. Connect to unlimited farms via invite codes. You can also create your own farm at the same time — the "Create Your Own Farm" button on the vet home screen lets you manage both vet consulting AND your own farm in a single account.

1. On the sign-in screen, tap "Forgot password".
2. Enter your email address.
3. Click the reset link in the email.
4. Set a new password.

If you signed up with Google or Apple, there's no password — you log in with that account.

1. Tap the + (plus) button at the bottom of the home screen.
2. Required fields: Ear tag, birth date.
3. Optional fields: Name, leash number, gender (default Female), breed, group (default "Milking 1"), mother's ear tag, father's name, insurance, lactation number.
4. For females over 24 months, the system asks "Has this animal given birth before?"
5. Tap "Save".

You can group your herd into "Milking 1", "Dry", "Heifer", "Calf", etc. Two ways to add groups:

• Add/Edit Animal screen: Choose from the "Group" field or create a new one.
• Drawer (top-left menu) → Groups: Manage all groups in bulk, add new, delete.

Groups are crucial for feed management — you can assign different rations per group.

At the bottom of the animal detail screen, there's a "Remove from Herd" button. Tapping it offers 4 options:

• Sold → record archived, removed from herd (recoverable)
• Slaughtered → record archived, removed from herd
• Died → record archived, removed from herd
• Wrong Entry / Test Record (Delete) → permanently deleted, cannot be recovered

Yes. There's an Edit (pencil) icon at the top right of the animal detail screen's app bar. You can change all fields including the ear tag. Conflict checking is enforced — you cannot use another animal's ear tag.

No, ear tags must be unique within a farm. The system will throw an error on conflict.

1. Open the animal detail screen.
2. In the bottom menu, tap "Add Insemination".
3. Fill in date, bull name/breed, inseminator.
4. If the inseminator list is empty, tap the + (plus) button next to it to add a new person (Veterinarian / Technician / AI Technician). The added person stays in the list for next time.
5. Save → the animal status automatically becomes "Inseminated".

The insemination button appears in most reproductive states:

• The animal is female (males don't have a reproduction section)
• Reproductive status: Open, Fresh, Heifer (lactation=0), or Inseminated

The button is still visible in Inseminated state because if the previous insemination failed, you may need to add a new one. The Pregnancy Check button also appears alongside it.

The insemination button does not appear in Pregnant, Dry, Close-Up, or Freemartin states.

After insemination, the animal moves to "Inseminated" status. A blue "Pregnancy Check" button (with a doctor's bag icon) appears in the bottom area of the animal detail screen:

1. Tap the button.
2. Select check date.
3. Result: Pregnant or Open.
4. If Pregnant, expected calving date is auto-calculated (insemination date + 280 days, gestation can be changed in Settings).

When the animal is in "Close-Up" or "Dry" status, tap the "Calving" button from the status menu in the detail screen. The Smart Calving Wizard opens:

1. Enter the birth date (the system checks gestation period — under 240 days is abortion, 240-260 is premature warning).
2. Choose number of calves (single or twin).
3. For each calf: gender (Female/Male), condition (Alive/Dead).
4. Save → a new animal record for the calf is created automatically in the "Calf" group. You don't need to create it manually.

Two ways:

• Manual: In the animal detail screen's status menu, tap "Dry Off". A dialog suggests a group change (e.g., move to "Dry Period" group).
• Automatic: When a pregnant animal's expected calving is ≤ "Dry Off Period" threshold (Settings default 60 days), the morning summary reminds you of "drying off needed".

Two ways:

• Manual: On the detail card of a Pregnant or Dry animal, a "Move to Close-Up" button appears below the reproductive badge (when expected calving is ≤ "Close-Up Period" threshold). Tapping it opens a group selection dialog.
• Automatic: The system checks status daily; when calving is ≤ "Close-Up Period" (Settings default 21 days), the animal automatically moves to "Close-Up" status.

The morning summary also shows a "close to calving" alert.

Reproduction protocols are scheduled medical treatment plans used to synchronize insemination and increase pregnancy rates. Each step involves administering a specific drug (GnRH, PGF2α, etc.) or insemination on a specific day.

• Ovsynch (10 days): Day 0 GnRH, Day 7 PGF2α, Day 9 GnRH, Day 10 Insemination
• Cosynch (9 days): Day 0 GnRH, Day 7 PGF2α, Day 9 GnRH + Insemination (simultaneous)

These two protocols are pre-loaded. You can also create your own custom protocols.

1. Go to "Reproduction Protocols" screen.
2. From the top-right menu, tap "Create Custom Protocol".
3. Enter protocol name, description (optional).
4. Tap "+ Add Step" to define each step:
   • Day offset (0-30)
   • Action: Injection or Insemination
   • Active substance (GnRH, PGF2α, Progesterone, etc.)
   • Time (HH:mm)
5. Save — your custom protocol appears in the list.

1. "Reproduction Protocols" → select protocol → "Start".
2. Choose animal(s) (single or multiple).
3. Set start date and time.
4. Choose reminder timing: at the time / 2 hours before / 1 day before.
5. "Start".

The system schedules notifications for each step. Daily Tasks screen shows protocol tasks under "Reproduction Protocols".

Yes, the system applies automatic filters:

• Only female animals (excludes males/bulls/calves/yearlings)
• Reproductive status "Open"
• Age ≥ 12 months
• Animals already in an active protocol appear disabled in the list

1. Tap the "Milk" card on the home screen, or open the Milk menu.
2. Enter the daily tank milk as a single amount (not separated by morning/noon/evening — total tank in liters).
3. Unit choice: liters (L) or kilograms (kg). If you choose kg, the system auto-converts to liters (1 kg ≈ 0.97 L by density).
4. Save → daily total milk and income are calculated.

Two places:

• Milk history screen: Tap the monthly summary card → "Update General Price" or "Update Price for This Month".
• Settings → Milk Price: Set the general unit price (per liter) here.

The price you set is automatically applied to that day's/month's milk income.

The milk history screen shows in the top card:

• Monthly total liters
• Daily average
• Highest and lowest daily records
• Number of days with data
• Estimated monthly income

There's also a calendar view showing days with color coding (high = dark blue, low = light blue).

Daily milk records older than 1 year are automatically converted to monthly summaries: total liters, day count, average, max/min, average price, and estimated income are preserved; daily details are deleted. This keeps the app fast while preserving long-term trends.

Animal detail → "Vaccines" tab → "New Vaccine". Enter vaccine name, date, and next booster date (if any). The system sends an automatic notification when booster time arrives.

You can view all vaccines from two places:

• Vaccines card on the home screen — shows upcoming 7-day vaccines as a quick summary; tap to open the full vaccine calendar.
• Drawer (left menu) → "Vaccine Calendar" — view and plan all vaccines together.

Animal detail → "Health" tab → "New Disease". Fields:

• Disease name (Mastitis, Lameness, etc.)
• Severity (Mild / Moderate / Severe)
• Symptoms (free text)
• Veterinarian name
• Medication treatment: "Add Treatment" with drug name, dose, withdrawal days, applied by
• Resolution date (added later)

The withdrawal period is the wait time during which milk or meat from the medicated animal must not be consumed. When you enter medication + days, the end date is calculated automatically and a warning is shown on the animal.

You're alerted in the morning summary when withdrawal is about to end.

1. Go to "Feed Management" (Drawer → Feed Management).
2. Items tab: Define raw materials like corn, barley, soy, hay. Set unit (kg/ton) and minimum stock alert level for each.
3. Stock tab: Record each purchase — item, quantity (kg), unit price (per kg), purchase date, supplier (optional).
4. The system depletes stock with FIFO (first-in, first-out) automatically.

A ration is the daily feed mix for an animal (e.g., 5 kg corn + 2 kg barley + 1 kg soy).

1. Feed Management → "Rations" tab.
2. "New Ration" → enter name and description.
3. Add ingredients: item + per-head daily amount (kg).
4. Save.

Premium plan users can also use "AI Ration Suggestion" with Gemini-powered ration planning.

In "Rations" tab, tap the ration → "Assign to Group" → choose group (Milking, Dry, etc.). Assignment date defaults to today.

The system performs automatic consumption calculation daily:

Daily consumption = (active animals in group) × (per-head amount) × (days)

It depletes stock with FIFO and updates lastStockDeductionDate.

No. Currently, feed purchases and daily consumption costs are not automatically transferred to the Finance module. To track feed expenses, you must manually go to Finance → "Add Expense" → category "Feed".

Finance screen → "New Record" button. Choose type (Income / Expense), category, amount, date, description.

Income categories (fixed): Milk Sale, Animal Sale, Other.

Expense categories (fixed): Feed, Vet/Health, Energy, Labor, Maintenance, Insurance, Transport, Other.

No. Milk records are used for income calculation (shown in reports) but do not create automatic Finance income entries. You can manually enter monthly milk sales in Finance if you wish.

The filter button at the top of the herd screen opens these options:

• Quick filters: Problem animals (3+ failed inseminations), Pregnancy check needed, Drying off needed, Weaning needed, Ready to inseminate
• Animal type: Calf / Yearling / Heifer / Cow / Bull
• Reproductive status: Open / Inseminated / Pregnant / Dry / Close-Up / Fresh / Freemartin
• Numeric: Pregnancy days, Insemination days, Lactation number, Insemination count, Age (months), Milking days
• Date range: Birth, Last calving, Last insemination
• Other: Group/paddock (multi-select), Insurance yes/no

Multiple filters can be active — e.g., "Reproduction: Open" + "Age > 14 months" → list of heifers ready to inseminate.

Tap column headers to sort by ear tag, name, birth date, or reproductive status.

Drawer → "Reports" lists 9 different reports:

1. Herd Report
2. Breeding Report
3. Milk Report
4. Feed Report
5. Efficiency Report
6. Calf Report
7. Financial Report
8. Annual Report
9. Problem Animals

Some reports are package-locked (Premium / Platinum may be required).

• Total active cows, pregnant, open, fresh, dry, calf, milking cow counts
• Pregnancy rate (%) = Pregnant / Milking × 100
• Average calving interval
• Average inseminations per pregnancy
• Average days in milk
• Age distribution pie chart (Calf / Yearling / Heifer / Cow / Bull)
• Group distribution pie chart

• Total inseminations, successful, failed, pending
• Overall success rate (%) = Successful / (Successful + Failed) × 100
• Per-inseminator success rates: Each inseminator's individual success percentage (green ≥ 50%, orange ≥ 30%, red < 30%)
• Cow reproductive distribution pie chart
• Heifer reproductive distribution pie chart (including Freemartin)
• Combined reproductive distribution pie chart

• Last 12 months monthly total production — bar chart
• Last 12 months daily average — line chart

• Monthly feed cost — bar chart
• Item price trend — selected item's monthly average price (line chart)

• Efficiency % = (Milk Income − Feed Cost) / Milk Income × 100
• Daily milk income, daily feed cost, daily net profit
• Monthly profit/loss bar chart (profit green, loss red)
• Monthly detail table

• Total calf count (lactation=0)
• Female calf, male calf counts
• Total births, stillborn count
• Survival rate (%) = (Total − Stillborn) / Total × 100

A cumulative summary from year start to today — total births, total milk, total income/expenses, profit/loss, highest production month, etc.

A single list showing animals that need attention:

• Animals with 3+ failed inseminations still open
• Animals with active health issues
• Animals with ongoing withdrawal period
• Animals with overdue vaccines

1. Drawer (top-left menu) → "User Management".
2. Tap "Create Invite Code".
3. A 12-character code is generated (e.g., K7M3-N9PB-ZR2Y). Send it to your helper via WhatsApp/SMS/email.
4. Code is valid for 7 days.
5. That person signs up, taps "Join Farm" with the code → joins your team.

User Management → relevant member → "Permissions" button. You can set permissions for these 11 modules separately:

• View Animals
• Add/Edit Animals
• Delete Animals
• Remove from Herd
• Finance
• Milk Records
• Feed Management
• Vaccine Calendar
• Reports
• Settings
• User Management

By default, all permissions are on. Toggle off to restrict.

Same invite code system. The vet enters the code via "Join Farm" in their app. The system distinguishes by role automatically — a veterinarian connects as a consultant, a regular user joins as a member.

Vet permissions follow a different template: by default, Settings and User Management are off, other modules are on.

In User Management, tap the red remove button next to the person. After confirmation, that person loses access to your farm's data. (Veterinarians' farm lists are auto-cleaned on their next app open.)

On the vet home screen, tap "Join Farm" each time and enter a new invite code to connect to unlimited farms. You'll see all your farms in a list. Tap any farm to make it active and start working there.

Yes, both vet and farmer in a single account. On the vet home screen, tap "Create Your Own Farm", enter your farm name → you become the admin of your own farm. You can simultaneously consult for other farms; both roles work in parallel.

Yes. When accepting an invite code, you can assign a nickname (e.g., "Uncle Mehmet's Farm", "Branch B"). It appears in your list with that name; the actual farm name is unchanged.

On the vet home screen, tap a farm card → it becomes active, MainScreen opens, and you can view/edit its data. To go back and switch to another farm, return to the vet home screen via drawer or back button.

The system automatically schedules these notifications:

• Morning Summary (default 07:00) — overview of today's tasks: pregnancy checks, heat watch, calves to wean, drying off needed, close-to-calving, ready-to-inseminate, vaccines, withdrawal ending.
• Milk Reminder (default 20:00) — to remind you to log daily milk.
• Milk Payment Reminder (chosen day each month, 12:00) — to remind you to record last month's milk payment.
• Monthly Report (1st of each month, 09:00) — to review last month's summary reports.
• Protocol Step — for each step of started reproduction protocols (0/2/24 hours before, your choice).
• Vaccine Notifications — when recorded booster dates approach.

Yes. When a calf reaches the "Weaning Age" (Settings default 75 days), the morning summary shows "🍼 Wean calves" reminder. You can change the threshold in Settings → Farm Rules between 30-120 days.

Settings → Notification Settings:

• Enable/disable all notifications
• Morning summary time
• Milk reminder time and on/off
• Milk payment reminder day and on/off

1. Check that VetAsistan / CattleMate has notification permission in your phone settings.
2. In-app, Settings → Notification Settings, enable the notification types you want.
3. Battery saver, "Do Not Disturb", or "Data Saver" modes may be blocking notifications.

The "clocks" of your farm's reproductive management — the system performs automatic status transitions and schedules notifications based on these rules.

Settings → "Farm Rules" — 6 values can be configured:

The system runs on the new rules:

• If you change weaning age from 75 to 90: 75-day calves are no longer flagged for weaning, only after 90 days.
• If you change close-up period from 21 to 14: animals move to "Close-Up" status later.
• If you change pregnancy check day from 40 to 30: the reminder is sent 30 days after insemination.

Existing records are not changed — only system behavior follows the new thresholds.

15 languages: Turkish, English, Arabic, Danish, German, Spanish, French, Hungarian, Italian, Dutch, Norwegian, Polish, Portuguese, Romanian, Russian.

1. Settings → Language option.
2. Choose your preferred language from the list (flag emoji + name).
3. The app switches instantly.

If you don't choose a language, the app uses your system language. If your device language is unsupported, it falls back to English.

1. Settings → "📊 Download My Data" button.
2. Choose from the menu:
   • 💾 Save to Device — save to your phone's Files app.
   • 📤 Share — share via email, WhatsApp, Drive, etc.
3. All your data is prepared as an Excel file (.xlsx) — 13 sheets: Info, Animals, Inseminations, Births, Vaccinations, Health, Milk, Finance, Feed Items, Feed Stocks, Rations, Group Rations, Feed Consumption.

Yes, it's round-trip compatible — you can use your own exported Excel as a template.

1. First, export a backup using the method above (use as template).
2. Open the Excel on your computer/tablet → add new rows to the "Animals" sheet (ear tag and birth date are required).
3. Send the file back to your phone.
4. Settings → "Import Animals from Excel".
5. Select the file → review valid/invalid rows on the preview screen → confirm with "Add X Animals".

Yes. All your data is securely stored on Firebase Firestore. The app continues to work even if internet is lost (an orange "No connection" bar appears at the top); changes sync automatically when connection returns.

Settings → Danger Zone → "Delete Account". After 3 confirmation dialogs, your account and all data are permanently deleted.

14-day free trial — all Platinum features unlocked. If you don't subscribe at the end of the trial, you'll be moved to Free.

For higher animal limits: info@cattlemate.app

🎁 Free Plan

• Up to 10 animals
• 1 user (owner only)
• Reproduction, health, daily tasks tracking
• Local data + cloud backup
• 3 basic reports (Herd, Milk, Breeding)
• AI ration suggestion: 5 uses total
• Notifications enabled

🚀 Starter Plan

• Up to 75 animals
• 1 user
• All basic reports
• Unlimited cloud backup
• Limited AI calls (1,000/month)
• Access to training videos
• Standard email support

💼 Premium Plan

• Up to 150 animals
• 4 users (members + veterinarians can be invited)
• All reports unlocked (9 reports — Herd, Breeding, Milk, Feed, Efficiency, Calf, Financial, Annual, Problem Animals)
• AI Ration Suggestion (Gemini-powered) — unlimited
• 5,000 AI calls per month
• Inseminator success analysis
• Advanced financial charts
• Priority email support

💎 Platinum Plan

• Up to 1,000 animals (for higher limits, contact info@cattlemate.app)
• 10 users (for large teams)
• All Premium features
• Unlimited AI calls
• Veterinarian management module — manage multiple vets with different permissions
• Enterprise support (live chat, phone)
• Early access to beta features
• Custom report requests

iPhone: Settings → Apple Account → Subscriptions → CattleMate → Cancel.

Android: Play Store → My Account → Subscriptions → CattleMate → Cancel.

Refunds are processed according to Apple or Google's refund policies.

• Apple: reportaproblem.apple.com
• Google: Request via your Play Store account

1. Check your internet connection (an orange "No connection" bar at the top means no internet).
2. Once connection is back, the app syncs automatically.
3. If problem persists, fully close the app and reopen.
4. Still having issues? Email support@cattlemate.app.

Fully close the app (from task manager) and reopen. If problem persists, update the app from App Store / Play Store.

Your data is not deleted — it's safely backed up to the cloud. Make sure you signed in with the right email. If you have multiple accounts, check which one you originally signed up with.

When the admin account is deleted, the system automatically promotes you to admin of your own farm. On your next app launch you'll see an orange info banner: "The farm you were linked to has been deleted. A new farm has been created for you."

What happens to my plan? Your existing plan is preserved. As a member you were already on the "Free" plan, and you continue on Free after being promoted to admin. To raise your animal limit or unlock features, upgrade via Settings → Subscription.

What about animals? Animals from the old farm are deleted (they belonged to the admin). You start as a fresh-zero-animal owner of your own new farm.