Alpaca Guru User Guide

---

Welcome to Alpaca Guru - your comprehensive farm management solution for alpaca farms. This guide will help you get started and make the most of all available features.

Table of Contents

• Getting Started
• Managing Your Farm
• Alpaca Advisor
• Subscriptions and Plans
• Team Collaboration
• Notifications
• Animal Management
• Animal Health
• Paddocks and Points of Interest
• Activity Logging
• Breeding and Reproduction
• Tasks
• Your Profile
• Your Account
• Working Offline
• Troubleshooting
• Tips for Success

Getting Started

Starting the App

When you open Alpaca Guru and you're already signed in, you go straight to your farm — no need to log in again, and this works even without an internet connection (your farm data is shown from the device's cache). On the very first launch the app briefly shows a loading spinner while it resolves your sign-in state. If you're not signed in, you'll see a welcome screen highlighting key benefits:

• Track health, breeding, and lineage with ease
• Collaborate with your team in real-time
• Access comprehensive records, online or offline

Tap "Get Started" to sign in or create an account.

Creating an Account

• On the sign-in screen, tap "Don't have an account? Sign up"
• Enter your email address and choose a password (minimum 6 characters)
• Confirm your password — both fields must match
• Check the box to agree to the Terms of Service and Privacy Policy (required — tap the links to read them; the Sign up button stays disabled until you check the box)
• Tap "Sign up" and complete the short security check (CAPTCHA)
• Verify your email: A verification email is sent to your address. Open it and confirm your account before signing in — trying to sign in first shows "Please verify your email address before signing in"

Signing In

• Enter your email address and password
• Tap "Sign in" and complete the short security check (CAPTCHA)
• You'll be taken to your farm (or to farm setup if you don't have one yet)

Forgot your password? Enter your email address first, then tap "Forgot password?". A reset link is sent to your inbox.

Signing in requires an internet connection. If you're offline, an orange banner appears at the top of the screen.

Create or Join a Farm

If you don't belong to a farm yet, you'll see two options (both require an internet connection):

• Create a New Farm:

- Tap "Create new farm" - Enter your farm name and tap "Create" - You automatically become the farm's admin - The new farm may take a moment (1-2 seconds) to appear in your farm list

• Join an Existing Farm:

- Tap "Join existing farm" - Enter the 8-character invitation code you received from a farm admin (format: XXXX-XXXX — the dash is added automatically as you type) - Review the invitation details showing your invited role and the code's expiration date - Tap "Request to Join" - Wait for the farm admin to approve your request — once approved, the farm appears automatically

You can also sign out from this screen if you logged in with the wrong account.

Understanding the App Layout

Once you're in a farm, a bottom navigation bar appears at the bottom of the screen with five tabs, always in this order:

• Home — the dashboard for the selected farm
• Animals — your alpaca list
• Map — the Farm Map, and the home for paddocks, fences, and points of interest
• Logs — the full log history
• Chat — the Alpaca Advisor, an in-app AI chat for husbandry questions (see Alpaca Advisor)

Each tab remembers exactly where you left it — its own screens and scroll position — when you switch between tabs. Tapping the tab you're already on returns it to its top-level screen. Full-screen flows (such as creating a farm, adding a log, or the plan screen) open above the bar, which is hidden until you finish or cancel.

The Home tab shows the Farm Home Screen with:

• Farm selector in the title bar (tap to switch farms)
• Notification bell with an unread-count badge — opens your notification inbox
• Sync badge (cloud icon with a count) when changes are waiting to be sent to the server
• Connectivity indicator showing online/offline status
• Profile avatar — tap to open your account hub (profile, team management, notifications, subscription, sign out)
• Tasks card — when Tasks is enabled for your account, your open tasks with quick actions to add a task or view the full list
• Getting Started cards to guide you through setup
• Daily fact — when enabled for your account, a modest "Did you know?" alpaca fact
• Recent Activity showing your latest log entries

Managing Your Farm

Farm Home Dashboard

The Farm Home Screen is your central hub for farm operations:

• Switching Between Farms

- Tap the farm name in the title bar - A panel slides up showing all your farms with a checkmark on the current one - Tap a farm to switch to it - You can also create a new farm or join another farm from the same menu

• Moving Around the App

- Use the bottom navigation bar to reach Animals, Map, Logs, and Chat — each is its own tab - To start a new log, open the Logs tab and tap the + button (the new log flow asks what you're logging about first)

• Team

- Once your farm has more than one member, a Team card shows overlapping member avatars, the member count, and — when applicable — how many members are read-only guests (for example, "5 members · 2 read-only") - Tap the card to open Team Management - While you're the only member, the "Build Your Team" getting-started card appears here instead

• Tasks

- The Tasks card appears only when Tasks is enabled for your account: with open (unfinished) tasks, it shows how many are pending and up to three of their titles; with none, it shows a short "no open tasks" message - Admins and coworkers see a New task button on the card to add one directly - Tap Show all to open the full Tasks list (open and completed)

• Expecting Summary (Breeding)

- When at least one of your dams is "expecting" (has a recorded mating with no later birth or death), a card appears showing how many are expecting and up to three of their names - The count is a neutral label and never asserts a confirmed pregnancy - Tap Show all to open the full Expecting list - The card is hidden when no dams are expecting

• Getting Started Cards

- The dashboard intelligently shows the next relevant setup step: - Build Your Team: Appears when you're the only member - Add Your Animals: Shows when no animals exist - Create Your Paddocks: Switches to the Map tab, where admins can draw a fence or plan a paddock before fencing it - Start Logging: Starts the new log flow - Each card shows a step counter (e.g., "Step 1 of 4"), a description, and an action button - Skip steps if not needed right now — cards disappear once completed or skipped

• Recent Activity

- View the 10 most recent logs grouped by event date below the cards above - Event-date groups include "Today", "Yesterday", weekday names, or month/day - Each log shows: - Colored accent strip and icon matching the log type - Event type with translated label - Primary value (if applicable) - Animal names (up to 3, then "+N" for more) - Single-line note preview - Relative event date (e.g., "2d ago", "Just now") - Creator name - Camera icon if photos are attached - Tap "See all" to view complete log history - Tap any log to view full details

• Daily Fact

- When enabled for your account, a modest "Did you know?" card with a daily alpaca fact appears below the Expecting summary - When it is not enabled, Home stays quiet with no empty card or disabled message

Creating Multiple Farms

You can manage multiple farms from one account:

• Tap the farm name in the title bar
• Select "Create new farm" at the bottom
• Enter the farm name and create
• Switch between farms anytime using the selector
• Each farm maintains separate data and team members

On the free plan, "Create new farm" (here and on the initial farm-selection screen) shows a lock once you're at the plan's farm limit — tapping it opens a short "Create more farms" prompt with a See plans button instead of the create form.

Alpaca Advisor

The Alpaca Advisor is an in-app AI chat for husbandry questions — feeding, general health, breeding, fiber, and everyday management. Open it from the Chat tab in the bottom navigation bar. You can ask about the whole herd or focus the chat on one alpaca from your farm.

The Advisor gives general educational information; it isn't a veterinarian and can't examine your animals. Every answer reminds you of that, and answers can be incomplete or wrong — treat them as a starting point, not the final word when an animal's health or safety is at stake.

Starting a Conversation

The chat is per-visit only: it starts fresh each time you open it, and nothing is saved once you leave. The first time you send a message, a safety notice appears explaining what the Advisor can and can't do, and lists the signs that mean "call a vet right away" (an animal down and unable to rise, struggling to breathe, straining or bleeding heavily, a difficult birth, or a painfully swollen belly). Tap I understand to continue — this notice can't be swiped away or dismissed any other way, and your question is answered automatically once you accept it.

A short safety reminder stays visible at the top of the chat the whole time, and every single answer carries its own brief note to contact your vet if something seems off — alpacas are stoic and tend to hide illness, so it's always safest to act early.

Asking Questions

Type your question and tap send. A "thinking" indicator shows while the answer is generated. Some answers include a Suggested reading link to a related help article, which opens in your browser. If a message fails to send, tap its "Something went wrong — try again" bubble to retry.

Under most answers, you can tap the thumbs-up icon to mark it "Helpful," or Report to flag a problem (with an optional note on what's wrong).

Asking About One Alpaca

A chip under the safety banner shows the current subject. It starts as Your whole herd for general questions. Tap it to open a searchable animal picker, then choose an alpaca to switch the chat to About {name}. Switching between the whole herd and a specific alpaca starts a fresh conversation for that subject, so answers do not mix contexts.

You can also type @ in the message box to open an alpaca list above the composer. Choosing an alpaca inserts an @Name token and switches the same subject chip to that alpaca. The chip is the source of truth for the active context; editing the typed token or typing extra @Name text does not change which alpaca the Advisor is using.

When you ask about one alpaca, the Advisor can use that animal's authorized records, such as lineage, body condition, weight trend, reproductive status, treatment category and recency, health-log frequency, recent event type/status/recency, and a server-cached event-history summary. Sensitive details are filtered by the server, so raw log notes, medication details, private data, and unrelated herd records are not exposed as Advisor context.

While the Advisor is generating an answer, subject switching is disabled until the answer finishes.

Your Question Allowance

How many questions you can ask depends on your farm's plan, and resets on a schedule:

• Free: 3 questions per week
• Individual: about 10 questions per day
• Team: 10 questions per covered Team user per day, pooled at the farm level and shared by covered members of that farm

A counter above the message box shows how many you have left. Team farms show shared-pool wording because the allowance belongs to the farm's covered Team pool, not to separate personal buckets. Once the allowance is used up, the message box is replaced by a notice stating when it renews, with a See plans button if you'd like to upgrade — your conversation so far stays visible, you just can't send a new message until the next period (or an upgrade) unlocks more.

Asking the Advisor requires a connection — if you go offline mid-chat, the message box disables until you're back online.

Subscriptions and Plans

Alpaca Guru offers a free plan plus two paid plans. Subscriptions are available on iPhone and iPad first; Android support is coming in a later update.

Plans

• Free: 1 farm and up to 5 animals per farm. You can still invite read-only guests.
• Individual: Unlimited animals on your farm, read-only guests, and all features.
• Team: Everything in Individual, plus unlimited farms and a pool of seats so your teammates can edit (see Team Collaboration). Team plans come in 3, 5, 10, and 20 seats.

Each paid plan includes a 7-day free trial, and you can choose monthly or annual billing — annual gives you two months free.

Subscribing

• Open your profile and tap Subscription (you'll also be offered plans when you reach a free-plan limit).
• Choose Annual or Monthly at the top — the prices on each plan card update to match.
• For Team, pick the number of seats (3, 5, 10, or 20) with the seat chips.
• Tap Start free trial (or Subscribe) on the plan you want and complete the App Store purchase.
• A short "Activating your plan…" message appears while your plan is confirmed, followed by "Your plan is now active".

Prices shown are your store's local prices, including any active promotions.

Managing Your Subscription

• If you're already subscribed, the plan screen shows Manage subscription, which opens your App Store subscription settings to switch, upgrade, or cancel.
• Restore purchases at the bottom of the screen re-checks your account if a purchase isn't showing.
• The plan screen also shows your current plan and, for paid plans, the renewal date.

What the Free Plan Limits Mean

When you're on the free plan, you can keep 1 farm and up to 5 animals in it. If you already have more (for example, from a previous subscription), that data is kept safe — it's just locked for editing until you subscribe again. Subscribing restores full access instantly.

Trying to add a new animal or farm at the limit doesn't fail silently: the add button shows a small lock, and tapping it opens a short prompt stating the limit with a See plans button (and a Not now to dismiss) — never a confusing error.

The same 5-animal limit also applies to logging activity: on the free plan, only your farm's first 5 animals added to Alpaca Guru can have new activity logs added. An animal beyond that shows a lock icon wherever you'd pick it for a log — the log object list, an animal's own Add Log button, and the mother/dam/sire/female/test-male pickers in birth, breeding, and pregnancy logs — and tapping it opens the same kind of upsell prompt. Existing logs for every animal, including over-limit ones, are never affected.

Team Collaboration

Understanding Roles

Alpaca Guru uses four distinct roles:

• Admin: Full farm management access, can invite/remove members and approve requests
• Coworker: Can add/edit animals and perform daily operations
• Guest: Read-only access to view farm data
• Contact: Limited access for external breeding collaboration

Once your farm has more than one member, open Team Management by tapping the Team card on the Farm Home dashboard. You can also reach it from your account hub: tap your avatar on the Home tab, then Team Management. Admins see three tabs (Members, Pending Requests, Breeding Requests); other members see the members list only.

If your own access is read-only (you're a Guest, or a Coworker without an assigned seat or your own subscription), a small "Read-only" label appears in the app bar on the Animals, Logs, Tasks, and Map screens — a quiet reminder that you're viewing this farm without edit access. Open Team Management — via the Team card on the Farm Home dashboard, or your account hub — to see who can grant you editing access.

Inviting Team Members (Admin Only)

• Open your account hub (tap your avatar on the Home tab) → Team Management
• Tap the "Invite New Coworker" button (requires internet)
• Select the role for the new member from the dropdown
• Tap "Generate Code" to create an invitation
• Copy the 8-character code using the copy button
• Share the code with your team member (via text, email, etc.)
• The code expires in 7 days for security

If you pick the Coworker role but don't have a Team plan with an open seat, a note reminds you that the coworker will have read-only access until you assign them a seat (see Seats and Editing Access below).

Managing Team Members

• View Team Members

- See all members with their roles and contact info - Members are sorted by role (Admin → Coworker → Guest → Contact) - Your own entry is shown in bold - Profile photos or initials are displayed - Pull down to refresh the list

• Handle Join Requests (Admin Only)

- In Team Management, an orange badge on the "Pending Requests" tab shows the pending count - Switch to the "Pending Requests" tab - Review the requester's name, email, requested role, and invitation code - Approve — you can assign a different role than the one requested - Reject to deny the request

• Change Member Roles (Admin Only)

- Tap the three-dot menu next to a member - Select "Change role" - Choose the new role from the dropdown and save

• Remove Members (Admin Only)

- Tap the three-dot menu next to a member - Select "Remove member" and confirm - Note: You cannot remove the last admin, and you cannot remove or change your own role

All administrative actions require an internet connection — viewing the lists works offline.

Seats and Editing Access (Team Plan)

On a Team plan, a teammate can edit only when they are covered — either by their own subscription or by a seat you assign them. Teammates who aren't covered can still view the farm, but can't make changes.

Next to each teammate in the Members tab you'll see a small label:

• Covered (own plan) — the teammate has their own subscription and doesn't use one of your seats
• Seat assigned — you've given them a seat from your Team plan
• No seat — read-only — they have no seat and no subscription, so they can only view

Assigning and releasing seats (Team owner):

• Open Team Management → Members tab. A summary card at the top shows how many seats are in use, for example "Seats: 2 of 5 used — you + 1" (you always occupy one seat yourself).
• Use the switch next to a teammate to give them a seat (on) or take it back (off).
• When all seats are in use, the switch to add a new one is disabled and a "Pool full — upgrade for more seats" note appears. Free up a seat or move to a larger Team plan to add more.

Seat changes need an internet connection.

When Editing Is Paused

If editing is paused for you or your team, a banner at the top of Team Management explains why:

• If you're a teammate without a seat: the banner tells you to ask the farm owner for a seat.
• If you're the farm owner and a teammate is blocked because you're not subscribed: the banner offers a See plans button that opens the subscription screen so you can enable editing for your team.

Handling Breeding Requests (Admin Only)

Other farms may request connections involving your animals. These appear in the "Breeding Requests" tab, organized in four categories:

• Breeder Requests: Another farm wants to list your farm as an animal's breeder
• Lineage Requests: Another farm wants to link one of your animals as a parent (sire or dam) of their animal
• Spit-off Tests: A spit-off test was recorded using one of your males — the request shows the test female, test male, date, and result.

For each request you can Approve or Reject.

Notifications

Alpaca Guru sends push notifications to keep you informed about your farms. Notification setup happens automatically once you sign in — the first time you sign in on a device, your phone asks for permission to show notifications. If you decline, the app keeps working normally; you just won't receive notifications (you can enable them later in your device settings).

Request Notifications (On by Default)

Admins receive a notification when:

• Someone submits a new join request
• Another farm sends a breeder, lineage, or spit-off test request

Requesters receive a notification when their own request is decided:

• A join request is approved or declined
• A breeder, lineage, mating, or spit-off test request is approved or declined

Tapping a request notification opens the app directly on the relevant Team Management tab — and switches to the farm the notification refers to — whether the app was in the background or fully closed.

Farm Activity Notifications (Off by Default — Opt In)

You can also be notified about everyday activity on your farms. These are strictly opt-in — nothing is sent until you turn a type on in the notification settings:

• Births: A cria birth is recorded on one of your farms — tapping opens the cria's animal details
• Animals added: An animal is added to one of your farms — tapping opens the animal's details (animals registered through a birth are announced by the Births type instead, never twice)
• Sales and deaths: An animal sale or death is recorded — tapping opens the animal's details
• New team members: Someone joins one of your farms — tapping opens Team Management's Members tab

A notification is never sent to the person who triggered the action, and notification text arrives in each device's own language.

Choosing Which Notifications You Receive

Open the notification settings (from your account hub → Notifications, or from Profile → Preferences → Notifications) to control exactly which notifications you get, per event type:

• Requests group: five toggles (join, breeder, lineage, mating, and spit-off test requests) — all on by default
• Farm activity group: four toggles (births, animals added, sales and deaths, new team members) — all off by default
• Tasks group: when Tasks is enabled for your account, two toggles (task due reminders and overdue task reminders) — both on by default; reminders arrive at 08:00 in your local time (see Tasks)
• Flipping a switch applies immediately; if saving fails (e.g. no connection), the switch flips back and an error message appears
• Your choices are stored on your account and apply on every device you sign in to
• Disabled types are never sent at all — the server checks your preferences before sending each notification

The Notification Inbox

The bell icon in the Farm Home app bar opens your notification inbox, where you can review the notifications you've been sent — handy for catching up after time away:

• The bell shows a badge with your unread count (hidden when everything is read)
• Notifications are listed newest first; unread items show a colored dot and a bold title
• Tap a notification to mark it read and open the same screen the original push would have opened (the app switches to the right farm first)
• Mark all read: Tap the done-all icon in the app bar to clear everything unread at once
• Delete: Swipe a notification sideways to remove it (permanent — there is no undo)
• The inbox keeps your 50 most recent notifications — older ones are trimmed automatically
• The inbox mirrors exactly what was sent: notification types you've disabled don't appear there either

Animal Management

Viewing Your Animals

• Tap "Animals" on the Farm Home Screen
• Use the search bar to find specific animals by name
• Filter using the filter chips:

- Owned: Currently owned animals (the default) - Male / Female / Gelding: Filter by gender - Sold: Animals no longer in the herd — transferred to other farms or sold to outside buyers via a recorded sale - Deceased: Animals that have passed - Pedigree: External animals from other farms that are referenced for lineage only (e.g., approved external parents) - All: Show everything

• Switching between filters is instant — the list updates in place with no reload, even offline
• Animals are automatically grouped into sections: Owned, Sold, Deceased, and Pedigree (sections are hidden when empty)
• Each animal card shows a gender-colored avatar, name, breed, age (e.g., "3 mo", "15 y"), and primary identifier (ear tag or microchip). External animals carry a "Pedigree" badge, and animals archived via a recorded sale show a "Sold" chip

Adding a New Animal

• Tap the + button (visible to admins and coworkers only). On the free plan, once you're at the per-farm animal limit the button shows a small lock instead — tapping it opens a short "Add more animals" prompt with a See plans button rather than the add form.
• Fill in the basic information:

- Name (required) - Gender (Female, Male, or Gelding — required) - Breed (Huacaya or Suri — optional) - Birth date (optional, tap to pick a date) - Status (Alive or Deceased — only farm admins can change this field; others see it grayed out. Sold is never set manually — an animal only becomes Sold when you record a sale from its details screen or transfer it to another farm) - How acquired (when adding only): choose Born here (the default) or Purchased. Selecting Purchased reveals the purchase fields: - Purchase date (required, defaults to today; cannot be in the future) - Seller (optional) - Price (optional) and currency (3-letter code, pre-filled from your currency preference (Profile → Preferences) or your device's region; the currency field is enabled once a price is entered). The price field accepts either a comma or a dot as the decimal separator (for example, 1,5 or 1.5) - The acquisition record is fixed at creation — it cannot be changed when editing the animal later - Breeder Farm (select from the farms you belong to; selecting another farm sends an approval request to that farm)

• Add identification:

- Ear tags: Add multiple tags - Microchips: Track chip numbers - Registrations: Pick an organization and enter the registration number

• Select colors:

- Tap "Select Colors" to open the color picker - Choose from standard and special color options - Selected colors appear as removable chips

• Set lineage information:

- Dam (Mother): Select from females across all your farms, or type a name manually - Sire (Father): Select from males across all your farms, or type a name manually - Animals in the dropdown are grouped by farm

• Add notes (optional)
• Save — works even offline (see Working Offline)

External Parents and Breeders (Approval Flow)

When you select a parent animal or breeder farm that belongs to another farm:

• Before saving, a "Request Approval?" dialog lists the approvals that will be requested — confirm or cancel
• The request is sent to the other farm's admin ("Request sent to farm owner")
• While waiting, an orange "Pending approval from [farm name]" indicator is shown for that parent — you can cancel the pending request from the edit form
• Once the other farm's admin approves, the connection becomes verified and shows a blue checkmark
• Sending approval requests requires an internet connection

Viewing Animal Details

• Animal Overview Screen

- Tap any animal from the list - See the animal's avatar, name, birth date with age, and gender in the header - View recent activity logs for this animal (up to 5 shown) - Tap "View all" to see this animal's complete log history (just this animal's logs, nothing else) - Use the + button to add a new log for this animal (admins and coworkers). On the free plan, if this animal is beyond your farm's first 5 registered animals, the button shows a lock instead and opens a "See plans" prompt

• Animal Details Screen

- Tap "Details" from the overview screen - A Health row at the top opens the animal's Health view — health trends, health-log history, and, when Tasks is enabled for your account, care schedules (see Animal Health) - View comprehensive information including: - Birth date and breeder farm - The animal's current paddock (or "No paddock" when unassigned) - Identification (ear tags, microchips, registrations) - Colors - Lineage (dam and sire) - Notes - Blue checkmarks indicate verified connections to real farms/animals - Orange banners show pending approval requests ("Pending approval from [farm name]")

• The Paddock Row

- Tap the row to open the paddock's detail screen (when the animal is assigned) - Movement history (history icon): opens a filtered log list showing only this animal's movement entries — movements are recorded automatically every time the animal's paddock changes, no manual logging needed - Change paddock (swap icon, admins and coworkers): opens a picker listing the other paddocks with their occupancy — pick one to assign or move the animal. The action is disabled when there's nowhere to move to (no paddocks exist, or the animal is in the farm's only paddock) - Paddock changes work offline — the change is queued and a "Saved offline" message is shown

Recording Sales, Deaths, and Purchases (Admin Only)

Farm admins can record lifecycle events from the three-dot menu on the Animal Details Screen:

• For an alive animal: "Record sale" and "Record death"
• For a sold animal: "Record purchase" (buying the animal back)
• For a deceased animal: no lifecycle actions apply

Selecting an action opens a form sheet:

• Event date (required, defaults to today; cannot be in the future)
• Buyer (for a sale) or Seller (for a purchase) — optional counterparty name; not shown for a death
• Price (optional) and currency (3-letter code, pre-filled from your currency preference (Profile → Preferences) or your device's region; enabled once a price is entered)
• Notes — or Cause / notes for a death
• Tap the action button (e.g., "Record sale") and confirm in the dialog

After recording:

• The animal's status changes — a sale moves it to the Sold archive, a death to the Deceased archive, and a purchase brings it back into the active herd
• Sold and deceased animals are removed from their paddock automatically, freeing the place
• An activity log entry (animal sale / animal death / animal purchase) is created automatically with the date, counterparty, amount, and notes
• Works offline: the event is queued with a "Saved offline" message and appears on the Waiting to sync screen as "Lifecycle event"

Editing Animal Information

When editing an animal (pen icon in the details view — admins and coworkers only):

• Update any basic information
• Modify identification details
• Change colors or lineage
• Update breeder information
• Cancel pending approval requests if needed
• Delete the animal (with confirmation — permanently removes it)

Animal Health

Each animal has its own Health view — a single place for health trends and health-log history, plus upcoming care schedules when Tasks is enabled for your account, without the noise of unrelated activity.

Open it from the Health row at the top of the animal's Details screen.

Care Schedules

When Tasks is enabled for your account, the Health view lists this animal's recurring care schedules — earliest due first, with overdue ones highlighted. A schedule reminds you when a recurring treatment is due. Health history and trends remain available even when Tasks is disabled.

To set one up, tap Schedule treatment and pick a preset:

• Vaccination (defaults to every 12 months)
• Deworming (FEC/vet-guided; defaults to a 3-month reassessment cadence for the treatment plan)
• Fecal egg count (defaults to every 3 months)
• Custom (set your own)

Presets are editable starting points, not universal veterinary schedules. Adjust the cadence for your herd and local parasite or vaccination risk.

Then choose the first due date and how often it repeats (every set number of days, weeks, or months). A sensible title is filled in for you and can be edited.

A schedule is a recurring task for the animal. When Tasks is enabled for your account, it also shows up in the Tasks list and sends the same reminders — a push at 08:00 (your local time) on the day it's due, and once when it first becomes overdue. Each schedule row shows its title, its due or overdue status, and a repeat indicator, with a one-tap complete action. Completing a schedule automatically creates its next occurrence. Tap a row to open the task's details.

When Tasks is enabled, creating a schedule works offline — it's queued and synced automatically, like other tasks. Who can create and complete schedules follows the same rules as tasks (admins; the assigned member; the creator within 24 hours).

Health Trends

When the animal has recorded numeric health data, the Health view shows a Trends section with charts that make changes over time easy to spot. Charts appear in this order, and only for metrics the animal actually has data for:

• Weight — a trend line in kg (no healthy-range band, since a healthy weight varies from animal to animal)
• Body condition score — body score over time on a 1–5 scale, with a healthy-range band; readings outside the band are highlighted
• Temperature — in °C, with a healthy-range band; out-of-range readings are highlighted
• Heart rate — beats per minute, with a healthy-range band; out-of-range readings are highlighted
• Respiration rate — breaths per minute, with a healthy-range band; out-of-range readings are highlighted
• Fecal egg count — eggs per gram, shown with three color zones: green (under 200), amber (200–500), and red (over 500)
• Fleece — fibre-quality measurements (such as mean fibre diameter) over time; this is a quality trend, not a health measure, so it has no healthy-range band

If the animal has no data for any of these, the Trends section doesn't appear.

The healthy-range bands are population-level guidelines based on published alpaca husbandry practice. Individual animals can have naturally different baselines, so always consult a veterinarian for any clinical decision.

Health History

Below the trends, the Health view shows a list of the animal's health logs only, newest first. "Health" covers medical care (medications, vaccinations, deworming, surgery, dental and eye/wound care), health monitoring (temperature, weight, body score, observations, vitals), diagnostics (fecal egg count, blood tests, skin scraping), and the two health-related body-care items — nail trimming and skin check. Everyday items such as shearing, ear cleaning, and feeding stay in the general activity log and aren't shown here. If the animal has no health logs yet, an empty state is shown.

You record a treatment the usual way, through the add-log flow using the relevant log type (see Activity Logging); those entries then appear here automatically. The Health view itself shows from cached data when you're offline.

Paddocks and Points of Interest

Tap the Map tab (center of the bottom navigation bar) to manage your farm's paddocks, fences, and points of interest — the Farm Map is the home for all of this.

The Map Object List

Tap the list button to see every paddock and point of interest on your farm at once — a screen-reader-friendly way to reach everything the map shows (map markers and shapes aren't reachable by assistive technology), and the only way to reach a paddock that doesn't have a boundary yet. It has two sections you switch between: Paddocks and Points.

Paddocks:

• An unassigned-animals banner at the top, if any animals aren't assigned to a paddock (see below)
• Each paddock with a saved boundary shows its area, occupancy count — a plain count, or "current / capacity" (e.g., "5 / 8") when a capacity is set, turning red when over capacity — and a capacity bar. Tap the row to center the map on it, or the chevron to open full details
• A paddock without a boundary yet shows "No boundary yet" instead, with a Draw boundary button (admins/coworkers — starts the Add fence flow, linking the new fence to this paddock and having that paddock already selected when you save, though you can still change it) and an Open details link
• Admins see a New paddock (plan without boundary) button at the end of the list, for planning a paddock before its fence is drawn

Points: every point of interest, active ones first then alphabetically, each showing its type and Active/Inactive status. Tap a row to center the map on it (when it has a location); the chevron opens it for editing.

Unassigned animals banner: When at least one animal isn't assigned to any paddock, the banner shows how many (e.g., "3 animals without a paddock"). For admins and coworkers it's tappable and starts the assignment flow:

• Choose a paddock from the picker (skipped automatically when the farm has exactly one paddock)
• The add-animals sheet opens with all unassigned animals pre-selected — uncheck any you don't want to assign
• Confirm to assign them (works offline, like other assignment changes)

For guests the banner is informational only.

Paddock Summary Sheet

Tap a paddock's boundary on the map — or a closed fence linked to a paddock — to open a summary sheet: the paddock's name, area, an occupancy/capacity bar (same over-capacity coloring as the detail screen), a suggested-capacity hint when relevant, and a boundary breadcrumb (fence count and total length). Open details and Edit buttons take you further. The sheet opens as a swipeable pane at the bottom of the map — tap the map, drag the pane down, or use your device's back action to dismiss it. An open fence — a barrier, not a boundary — opens its own pane instead, with fence details rather than paddock details (see Farm Map Base View below).

Creating and Editing Paddocks (Admin Only)

• Tap New paddock (plan without boundary) in the map's object list (or the Edit button on a paddock's detail screen or summary sheet)
• Enter a name (required — the Save button enables as soon as you type one)
• Optionally add a description and a capacity:

- There's no manual area field — a paddock's area is computed from its fences (the geometric union of its closed fence boundaries; open fences are barriers and add no area). Draw or manage fences on the Farm Map; the area then shows on the paddock's Boundary section, in each team member's preferred unit - When the paddock already has a computed boundary area, a suggested capacity appears under the Capacity field, based on a rough good-pasture estimate of about 8 alpacas per hectare. A hint frames this as an estimate for good pasture — your land may carry fewer — never a hard limit; tap Use to fill it in with one tap

• Save — a "Paddock saved" confirmation appears

You can also create a paddock while drawing its fence: after finishing a closed shape on the map, the save dialog lets you name a brand-new paddock instead of picking an existing one.

Deleting a paddock: When editing, a "Delete paddock" row appears at the bottom. It stays disabled while the paddock contains animals ("Remove all animals from the paddock before deleting it") — empty the paddock first, then tap delete and confirm.

Creating, editing, and deleting paddocks require an internet connection.

Managing Animals in a Paddock

Open a paddock to see its occupancy, capacity bar, area, and an alphabetical list of the animals inside. Tap an animal to open its details. Admins and coworkers can manage assignments:

• Add animals: Opens a sheet listing every farm animal not already in this paddock, grouped with unassigned animals ("Without paddock") first, then one group per other paddock. Animals from other paddocks carry the hint "Will move from [paddock]" — confirming moves them here. Tick the animals and confirm
• Batch move or remove: Tap the Select button (checklist icon) to switch the list to checkbox mode, then:

- Move selected: pick a destination paddock from the list (disabled when the farm has no other paddock) - Remove selected: confirm to unassign the selected animals from any paddock - Batch changes are sent as a single request, so moving the whole herd at once is fast and shows up as one entry when queued offline

• Edit Paddock (pencil icon, admins only): rename, change description or capacity, or delete (area is computed from the paddock's fences, not edited here)

All assignment changes (add, move, remove) work offline — they're queued with a "Saved offline" message and sync automatically.

Paddock Boundary and Fence Management

Paddock details include a Boundary section. If the paddock has a saved fence boundary, the section shows that it is saved, the enclosed area, and a View on map action that switches to the Map tab and centers the camera on the paddock's fences. The area is computed as the geometric union of the paddock's closed fences (overlapping fences aren't double-counted, and open fences are barriers that add no area), so it matches the value shown on the Farm Map. If no boundary is saved yet, it points you back to the Farm Map to draw one.

Below the boundary summary, each fence linked to the paddock gets its own row — name, length, and open/closed state; a paddock with more than one fence (a union boundary) lists them all here. Admins and coworkers get a menu on each row to Rename, Change paddock (re-link to a different paddock on the same farm), Edit boundary, or switch between Open and Closed (closing adds the fence's area to the paddock, opening removes it — the app confirms first and names the impact); admins can also Delete it. These are the same actions previously reached from the fence's pane on the map — for a fence that's a paddock boundary (closed and linked), tapping it on the map now opens the paddock's summary sheet instead, so its management lives here. A fence that's just a barrier (open, or a rare closed fence not yet linked to any paddock) still manages directly from its own pane on the map.

Editing a fence's boundary: admins and coworkers can move, add, or remove a fence's posts directly on the map without redrawing it — tap Edit boundary from the paddock's Boundary row or from an open fence's pane on the map. Tap any post to select it, or tap the line between two posts to select that segment instead; tapping elsewhere just deselects, so nothing you've already changed is lost. With a post selected, a small handle appears next to it on the map along with a distance ruler at the bottom of the screen — drag the handle to the side you want to push the post from, then set how far to move it, in tenths of a meter up to 15 meters. The post itself stays put while you adjust the distance; instead, a dotted preview shows where it would land, so you can see the result before it happens. The move only actually takes effect once you deselect the post. With a segment selected, an insert button lets you add a new post at its midpoint. Delete removes the selected post immediately, as long as the fence stays above its minimum (3 posts closed, 2 open); Undo steps back through your changes one at a time. Everything you do — moves, inserts, deletes — shows up on the map right away, with a subtle highlight on anything you've changed but not yet saved. If your edited boundary crosses itself, a heads-up appears but never blocks saving. Save applies the change (queued automatically if you're offline); if someone else changed the same fence first, you're offered a choice to reload their version or keep editing yours. Leaving without saving discards your changes, with a confirmation if you've made any.

Points of Interest

Points of interest (POIs) are places on your farm — water stations, feed stations, shelters, gates, medical stations, storage, and similar.

• Create a POI (admin): Tap Add a point on the Farm Map, aim the crosshair at the location, tap Place here, then fill in the form — or use the "+" button in a paddock's own Points of interest section, which preselects that paddock
• The POI form: Enter a name (required), pick the type from the dropdown, optionally add a description, tie it to a paddock (or "Not tied to a paddock" for farm-wide POIs), and set the Active switch (new POIs start active)
• Edit a POI (admins and coworkers): Tap its marker on the map and then Details in the pane that opens, the chevron on its row in the map's object list, or its tile in a paddock's Points of interest section
• Delete a POI (admin): Open it for editing and tap "Delete point of interest"

POIs tied to a paddock also appear in a "Points of interest" section on that paddock's detail screen, where admins and coworkers additionally get a quick Active/Inactive toggle directly on the tile — it flips instantly and reverts with an error message if the change can't be saved, a good way to retire a water station or shelter without deleting it. The map's own object list offers the same shortcut: a point linked to a paddock shows a small tappable chip with that paddock's name (opening its full detail), and admins and coworkers get the same inline Active/Inactive toggle right on the row, so retiring a point doesn't require opening its paddock or its edit form. Creating, editing, deleting, and toggling POIs require an internet connection; viewing works offline.

Farm Map Base View

Open Farm Map from the Map tab in the bottom navigation bar (its center position) — or from the "Create Your Paddocks" Getting Started step or a paddock detail screen's "View on map" action, both of which switch straight to the Map tab. The Farm Map opens directly to the map surface. It has no persistent bottom drawer or card, global Actions button, persistent location banner, or extra layers button (tapping a paddock still opens its own summary sheet, described above).

• Location permission: On load, Farm Map checks foreground When-In-Use location permission. If permission is missing, it shows a modal explanation first. Allow location requests the OS permission; Cancel closes the dialog without asking the OS.
• Automatic framing: When you open the Farm Map, it fits the view to everything on your farm — all your points of interest and fences — so the whole farm is on screen. If nothing is mapped yet, it centers on your location instead. Your location still shows as a marker, and Center on me re-centres on you whenever you want.
• Center on me: Tap the location button to center the map and start following foreground location updates. Tap it again or manually pan the map to stop following. If location is missing, the same modal appears first and follow starts only after permission is granted. Your location marker uses true GPS fixes — the app asks for the device's highest-accuracy positioning and filters out coarse network/Wi-Fi estimates, falling back to the best available position if a precise fix isn't ready yet.
• Map setup and load errors: Missing map setup keeps the map-style canvas visible and shows an in-map recovery message without displaying any token material. If the map genuinely fails to finish loading, the same recovery message appears with a Retry that actually reloads the map — a brief hiccup loading a single map resource during an otherwise normal load never triggers this message, and it clears itself automatically if the map goes on to finish loading anyway.
• Add fence placement: Tap Add fence to enter a local draft mode. Drag the map under the center crosshair, tap Place post to create Mapbox-backed fence posts, and review the draft live on the map. A short vibration confirms each post you place or undo. If the outline you're drawing crosses over itself, an amber heads-up appears in the command bar and the crossing point is ringed in red on the map — it never blocks saving (the enclosed area is simply approximate) and applies only to closed fences. After the first post, a dotted preview segment follows the current crosshair position until the next post is placed. The crosshair is only aiming chrome and is not saved or counted. Undo removes the last post you placed (repeatable); Center on me remains available, and follow mode moves only the map/crosshair target without changing draft posts. Finish (enabled once you have 2 posts) asks how to finish the fence: a Closed boundary — connecting the last post back to the first to enclose an area (needs 3+ posts, the default) — or an Open line, a barrier with no enclosed area (2+ posts). Then Save opens a dialog where you give the fence an optional name and either add it to an existing paddock or create a new paddock for it (creating a paddock is admin-only). Saving works offline — an offline save waits in Pending Sync, where it can be retried or discarded. Saved fences appear on the map in a calm silver/white — the same colour as one you're placing — with a solid outline; a closed fence adds a silver fill inside the outline, while an open fence shows the line only (no fill). A fence still syncing shows a dashed amber-tinted fill, and one that failed to sync a dashed red-tinted fill with a ⚠ marker (so sync state reads without relying on colour). Cancel exits and discards the local draft. Tapping a closed fence linked to a paddock opens that paddock's summary sheet instead of a fence detail (see Paddock Summary Sheet above) — its management actions live on the paddock's own detail screen. Tapping a saved open fence, or the rare closed fence not yet linked to any paddock, opens a detail pane showing its name, linked paddock, and — for a closed fence — the linked paddock's enclosed area (open fences enclose none), with a sync-status icon in the top row (tap it to read Saved / Syncing / Sync failed) and a Center on fence action. Every object detail pane on the map — paddock, point, or fence — opens and closes the same way: tap the map, drag the pane down, or use your device's back action to dismiss it (there's no separate close button); dismissing one also clears its highlight on the map, so switching between objects is tap-to-close, then tap-to-open the next one. Admins and coworkers can use the management actions, laid out two per row, to Rename the fence, Change paddock (re-linking it to another paddock in the same farm), or switch it between Open and Closed (which updates the linked paddock's size and suggested capacity), and admins can Delete it after a confirmation. These changes work offline and update the linked paddock's Boundary section.
• Points of interest on the map: Active points of interest that have a location appear as markers on the map — a neutral pin showing the POI type's emoji where one is set. Tap a marker to open its detail pane with its name, type, a Details button (opens the POI's form), and — for admins/coworkers — a Move button. The selected point is highlighted with a ring under its pin. The list button opens the full Map Object List described above, with a Points section covering every POI. Only active located POIs appear on the map itself; inactive (out-of-service) POIs stay in the list and are not shown on the map. Markers and the list button are hidden while placing or moving a point, while placing a fence, and when the map can't load.
• Add and move points on the map: Tap Add a point to drop a point at the map crosshair — aim, tap Place here, then fill in the name and type in the form. To relocate a point, select its marker and tap Move in its pane, aim the crosshair, and tap Save location (only its location changes). You can also place or relocate a point without the map by typing its Latitude and Longitude in the point form. Placing and moving need an internet connection and the same permissions as editing a point; there is no on-map delete (deleting stays in the form).

Movement History

The app records an animal movement log entry automatically whenever animals are assigned to, moved between, or removed from paddocks — you never need to log movements by hand. These entries appear in the farm's log list like any other log. To see a single animal's movements, use the movement history action (history icon) on the Paddock row of its details screen — it opens a log list filtered to just that animal's movement entries.

Activity Logging

The activity logging system lets you track all farm events and maintain comprehensive records for your animals, paddocks, and points of interest.

Creating New Logs

You can start a new log from:

• The + button on the Logs tab (admins and coworkers only — hidden for read-only members)
• The "New log" button shown by the "Start Logging" Getting Started card on the Home tab
• The + button on a paddock's detail screen (that paddock is pre-selected)

Logging starts by choosing what you're logging about, then what kind of log:

• Choose the object

- First you pick the animal, paddock, or point of interest the log is about - Objects are grouped into Animals, Paddocks, and Points of interest sections - Search by animal name, ear tag, or microchip, or by paddock or point-of-interest name - Only active, owned animals are listed (sold, deceased, and external animals are not offered) - On the free plan, an animal beyond your farm's first 5 shows a lock icon — tapping it opens a "See plans" prompt instead of continuing (see What the Free Plan Limits Mean) - When you start from a paddock's own screen, the object is already chosen and this step is skipped

• Choose the log type

- A searchable list opens, scoped to the types that make sense for the object you picked - A Common section at the top offers up to six shortcuts — your most recently used types for that kind of object, plus other common types - Below that, the remaining types are grouped under category headers (e.g., "Medical care", "Body care") - Start typing to filter the whole list in real time - Reproductive types (Mating, Birth, Spit-off test, Pregnancy loss) open their own guided screens directly (see Breeding and Reproduction); every other type opens the details form with the object already filled in

• Enter details

- Choose the event date — the date the event actually happened. It defaults to today and cannot be in the future - Select a subtype if available - Fill in the fields for the log type: - Notes: Optional free text - Value fields: Numbers with units (e.g., weight in kg) — required when shown - Selection fields: Dropdowns for predefined options - Add photos (when the log type supports them): take a photo or pick several from your gallery, preview them in a grid, and remove any before saving. Photos are automatically resized for efficient storage - Tap "Save log" — the entry appears immediately in all relevant places with the event date and your name recorded

Medication and Treatment Details

When you log a medication or treatment (for example oral medication, an injection, a pour-on or spot-on, deworming, a vitamin injection, or a vaccination), an extra Medication details section appears. Every field is optional — you can save a medication log with none of them:

• Route of administration — Subcutaneous (SC), Intramuscular (IM), Oral, or Topical
• Date administered — defaults to today and cannot be in the future; you can clear it
• Withdrawal period — a whole number of days, with a read-only "Safe to use after" date shown once both an administration date and a withdrawal period are entered. This is optional and market-aware — required in some markets (such as the EU/UK), not in others (such as the US) — and is never presented as a universal regulatory rule
• Reason for treatment and treating veterinarian — free text
• Pregnancy status — Pregnant, Not pregnant, or Unknown
• Last-recorded-weight hint — when you're logging for a single animal that has a recorded weight, its most recent weight and the date it was taken are shown, to help you work out a per-kilogram dose

For medication doses the amount must be greater than zero. When you open the log afterwards, only the details you actually filled in are shown.

Automatically Created Logs

Some log entries are created by the app itself and appear in the log list alongside manual entries:

• Animal movement logs — recorded on every paddock assignment, move, or removal
• Animal lifecycle logs (purchase, sale, death) — recorded when a lifecycle event is recorded from the Animal Details screen

You can also select these log types manually to create a plain note-style entry — but note that a manually created lifecycle log does not change an animal's status. Use the lifecycle actions on the Animal Details screen for that.

Viewing Logs

• Recent Activity on the Farm Home Screen shows the latest 10 logs grouped by event date
• Full Log List ("See all") shows all logs, newest first by event date, with type, animals, note preview, creator, and a camera icon when photos are attached
• Animal Overview shows each animal's 5 most recent logs
• Log Detail Screen — tap any log to see:

- A colored header with the log type, event date, and who created it - All recorded values with units - The related animals or other objects (animals are shown with avatars and names) - The full note text - A photo grid — tap a thumbnail to view full screen

Finding Logs (Filter, Search, and Date Range)

The full log list has controls above the entries to help you narrow a busy history. They work together — type and search and date are all applied at once:

• Filter by type: Tap the Type menu and pick a log type to show only entries of that kind. The menu lists only the types actually present in the current list
• Search: Type in the search field to match a log's note text — or the name of a linked animal, paddock, or point of interest
• Date range: Use the quick presets — Today, Last 7 days, Last 30 days, or This year. Tap the active preset again to clear it. Date ranges use the event date, not when the log was entered
• Clear filters: Resets the type, search, and date range all at once
• When your filters match nothing, a "No logs match" message appears with a button to clear the filters

Editing and Deleting Logs

• Who can edit or delete: Farm admins can edit or delete any log; the log's creator can edit or delete their own log within 24 hours of creating it. Other users see a read-only view
• To edit: Open the log → three-dot menu → "Edit log". Everything is pre-filled — change the event date, note, values, and selection options, remove existing photos or add new ones, then tap Save. The log type itself cannot be changed
• To delete: Three-dot menu → "Delete log" → confirm in the dialog

Breeding and Reproduction

Reproductive events have their own guided screens, reached through the Reproductive Events section when selecting a log type.

Recording a Mating

• Type in the dam field to search eligible registered females managed by your farm, then select a row to link the dam. Registered dams must be in the active herd (sold and deceased animals are not offered) and at least 18 months old. On the free plan, an owned dam beyond your farm's first 5 animals shows a lock icon and opens a "See plans" prompt instead of selecting
• Optionally type in the sire field to search eligible registered males, then select a row to link the sire. Registered sires must be male (not gelding), in the active herd, and at least 30 months old when the birth date is known. You can also type a visiting or unknown sire name as free text. The same free-plan lock applies to an owned, over-limit sire
• Choose the mating event date (defaults to today; cannot be in the future and is limited to the past year)
• Select the breeding method: Natural (default), Artificial Insemination, or Embryo Transfer
• Review the expected due date, calculated automatically as mating event date + 345 days (alpaca gestation) and shown as approximate — the typical planning range is about 335–350 days; it updates when you change the event date
• Add optional notes, then continue to finish and save the log entry

When you save a mating for a dam your own farm owns, the app adds her to the Expecting list (see below). If Tasks is enabled for your account, it also sets a one-time reminder for the approximate due date. Free-text (unregistered) dams are not added — no reminder is created and no external animal reference is stored.

At least one participant must be a linked registered animal managed by your farm before you can save. The other participant may be free-text, but typed-only names stay unlinked and do not create lineage, history, or associated-animal links. Duplicate names are not auto-selected; choose the exact row you mean. Registered animals from other farms are not offered as linked mating participants in this flow; enter outside/visiting participants as free-text names.

The mating event date is the same canonical date used for the log entry, the mating details, the approximate due date, the Expecting list, and Advisor/event-history chronology. Created and updated timestamps remain internal audit metadata.

The Expecting List

The Expecting list shows your farm's dams that have a recorded mating and an approximate expected due date, so you can see at a glance who may give birth soon. It is a "mated, outcome-unconfirmed" list based on mating dates — it never claims a confirmed pregnancy.

• Where to find it: an "Expecting" card on the Farm Home dashboard (shown only when at least one dam is expecting); tap Show all for the full list.
• What each dam shows: her name, an approximate due date ("Due approx. "), and a status badge — Due soon (within about 30 days of the due date), Past expected date (a neutral state — normal up to about 365 days' gestation), or Overdue — consult vet (beyond that, when veterinary attention is warranted). Badges are distinguished by icon and label, not colour alone.
• How a dam joins and leaves: she joins when you record a mating for a dam your farm owns, and leaves when you later record her birth or her death. If Tasks is enabled and a due-date reminder exists, that reminder is cancelled too.
• Known limitation: a pregnancy that ends early without a recorded birth or death isn't detected yet, so a dam may stay listed until her approximate due date passes. This is why the list and any due-date reminder copy are clearly marked as based on the mating date and not a confirmed pregnancy.

Recording Pregnancy Events

For alpaca, the Spit-off test and Pregnancy loss events are available, chosen when selecting the log type. Each opens its own guided screen ("Pregnancy loss" never uses a clinical term):

Spit-Off Test:

• Select the female to test — the dropdown offers your farm's Expecting dams, or type a name as free text. On the free plan, an owned female beyond your farm's first 5 animals shows a lock icon and opens a "See plans" prompt instead
• Optionally select the test male from the registered-male dropdown, or type a visiting male's name as free text. The same free-plan lock applies to an owned, over-limit test male; external test males are never locked
• Choose the test result: Positive (spits off = not receptive / possible pregnancy) or Negative (receptive)
• Add behavior observations in the notes
• Choose the date (defaults to today) and save

Selecting a registered male from another farm shows a confirmation before saving, since it sends an approval request to that farm. The log then shows the male's name as pending until the other farm approves or declines — you can cancel a pending request yourself from the log. If declined, the log stays editable so you can re-request or switch to a free-text name. A typed visiting male name never sends a request and stores no animal reference.

Pregnancy Loss:

• Select the female — the dropdown offers only dams with an open Expecting entry, or type a name as free text
• Optionally note the pregnancy stage (how far along the pregnancy was)
• Add symptoms and observations in the notes
• Choose the date (defaults to today) and save

Recording a pregnancy loss for a dam who is on the Expecting list removes her from it and, when a Tasks due-date reminder exists, cancels that reminder — the same way recording a birth or death does (see The Expecting List).

Recording a Birth

Selecting the Birth log type opens a guided three-step flow that also registers the newborns as animals on your farm:

• Select the mother: Search your farm's females by name or ear tag and tap the mother. Only females in the active herd owned by your farm are listed. On the free plan, a mother beyond your farm's first 5 animals shows a lock icon and opens a "See plans" prompt instead of continuing — including when she arrives already selected from her own animal page
• Enter cria details:

- Shared details for the birth event: - Birth date (defaults to today; limited to the last 30 days) - Time of birth (defaults to the current time) - Birth type: Natural (default), Assisted, or C-section - For each cria: - Name and gender (required; female/male/gelding) - Birth weight in kg, breed (Huacaya or Suri), ear tag, and microchip (all optional) - Health status: Healthy (default), Weak, or Stillborn — stillborn crias are registered as deceased animals so the record is preserved - Turn on Multiple crias for twins or triplets and add each cria in turn

• Review and confirm: Check the summary, optionally describe any birth complications, add notes, and tap Create birth record

Each cria is created as a real animal on your farm with the mother automatically linked as its dam, a confirmation shows how many crias were registered, and the birth is recorded as a log entry for the mother and all newborns.

Tasks

Tasks is your farm's shared to-do list when it is enabled for your account. If Tasks is not enabled, the Tasks card, task screens, task reminders, task counts, and task actions stay hidden or unavailable, with no prompt to set up or turn on Tasks from the app. When enabled, reach Tasks from the Tasks card on the Home dashboard: tap Show all to open the full list, or New task (admins and coworkers) to add one directly from the card.

Viewing Tasks

• A segmented control at the top switches between Open (unfinished) and Done (completed) tasks
• Open tasks are sorted with overdue ones first, then by due date; overdue tasks show a red "Overdue" chip with a warning icon
• Done tasks are sorted by completion date, most recent first
• Each task card shows its title, a due-date chip ("No due date" when none is set), and the assignee ("Unassigned" when no one is assigned)
• Recurring tasks show a small repeat indicator with the schedule (for example, "Every 8 weeks")
• All farm members — admins, coworkers, and guests — can view both lists

Creating a Task (Admins and Coworkers)

Tap the New task button on the Tasks list and fill in:

• Title (required, up to 200 characters)
• Notes (optional free text for any extra detail)
• Due date (optional) — pick a date from the calendar; clear it to set "No due date"
• Repeats (optional) — make the task recur every set number of days, weeks, or months. A due date is required to turn on repeating; until you set one, the row shows "Set a due date to make this task repeat"
• Assignee (optional) — choose any farm member, or leave it Unassigned
• Related to (optional) — link the task to an animal, paddock, or point of interest by first choosing the type, then the specific object

The Save button stays disabled until a title is entered. Guests cannot create tasks. Creating a task works offline — it's queued and synced automatically when you're back online.

Recurring Tasks

When you mark a recurring task complete, the app automatically creates its next occurrence with a fresh due date set to the completion time plus the chosen interval — so the next one is always in the future. To stop a task from repeating, edit it and choose "Doesn't repeat", or delete it. Clearing the due date also turns off repeating.

Completing, Editing, and Deleting Tasks

Open a task to see its full details — status, due date, assignee, the linked object, notes, and (for done tasks) who completed it.

• Mark complete: A "Mark complete" button appears on open tasks. You can complete a task if you're an admin, the assigned member, or the coworker who created it within the last 24 hours. Completing a task also records a "Task completed" entry in your farm's activity log
• Edit / Delete: Admins can edit or delete any task; a coworker can edit or delete a task they created within 24 hours of creating it. Deleting asks for confirmation first
• Completing, editing, and deleting tasks require an internet connection

Task Reminders

When Tasks is enabled for your account, you can get optional push reminders for tasks (see Notifications). Two reminder types, both on by default:

• Task due reminders — a reminder at 08:00 (your local time) on the day a task is due
• Overdue task reminders — a single reminder at 08:00 the day a task first becomes overdue

Reminders go to the task's assignee; for an unassigned task they go to the farm's seated members (read-only guests are not reminded). Each reminder is only sent if the recipient has the matching reminder turned on.

Your Profile

Accessing Your Profile

Tap your avatar in the top right of the Home tab to open your account hub, then tap Profile (see Your Account). Your profile shows:

• Profile photo or initial
• Display name (editable)
• Email address (read-only)
• A Subscription entry that opens your plan screen (see Subscriptions and Plans)
• A Preferences section (area unit, currency, and notification settings)
• A Logout option at the bottom

Managing Your Photo

Photo updates require an internet connection (the camera button is hidden when offline):

• Tap the camera button on your photo
• Choose "Take Photo" or "Choose from Gallery"
• Grant camera/photo permissions if prompted
• The photo is resized and uploaded automatically
• A green "Profile updated" message confirms success

Changing Your Display Name

• Tap the edit icon in the app bar
• Enter your new name (it cannot be empty)
• Tap Save — or Cancel to discard
• Works offline: If you're offline, the change is saved with a "Saved offline" message and syncs automatically when you're back online
• If the update fails, an error message appears below the form and you can retry

Preferences

The Preferences section on your profile lets you tune how the app presents measurements and money, and which notifications you receive:

• Area unit: Choose Hectares, Acres, or Automatic. Automatic follows your device's region (acres for US-style locales, hectares everywhere else) and shows what it currently resolves to, e.g. "Automatic (Hectares)". The chosen unit is used everywhere paddock areas are displayed
• Currency: Pick a common currency code (SEK, EUR, USD, GBP, NOK, DKK, CHF) or Automatic, which follows your device's region (e.g. "Automatic (SEK)"). The chosen currency is suggested on money fields, such as purchase and sale prices
• Selections apply immediately — there is no save button
• These two preferences are stored on this device only (they don't sync between devices) and work fully offline
• Notifications: Opens the notification settings, where you choose which push notifications you receive per event type — see Notifications. Unlike the measurement preferences, notification choices are stored on your account and follow you across devices

Signing Out

• Tap "Logout" at the bottom of the profile screen
• Confirm in the dialog
• You'll return to the welcome screen

Your Account

Tapping your avatar in the top-right corner of the Home tab opens your account hub — a single place that gathers all your account-level settings. From here you can reach:

• Profile — view and edit your name, photo, and profile details (see Your Profile)
• Team Management — your farm's members, pending join requests, and invitations (shown only when a farm is selected; see Team Collaboration)
• Notifications — choose which push notifications you receive (see Notifications)
• Subscription — view and manage your plan (see Subscriptions and Plans)
• Sign out — shown at the bottom in red; tap it and confirm to log out and return to the sign-in screen

Working Offline

Alpaca Guru is designed to keep working when you're out in the field without internet.

What Works Offline

• Opening the app: Once you've signed in on a device, the app starts straight into your farm even without a connection
• Viewing all data: Farms, animals, animal details, paddocks, points of interest, team members, and logs (from cached data)
• Navigation: Moving between all screens
• Searching and filtering: Finding animals by name, using filter chips
• Creating and editing animals: Saves are queued locally — you'll see a "Saved offline" message, and the change syncs automatically when connectivity returns
• Paddock assignments: Adding animals to a paddock, moving them between paddocks, and removing them — all queued offline
• Lifecycle events: Recording a sale, death, or purchase is queued offline ("Lifecycle event" on the Waiting to sync screen)
• Editing your display name: Also queued with a "Saved offline" message
• Area unit and currency preferences: Stored on the device, so changing them works fully offline

What Requires Internet

• Signing in and out (the first sign-in on a device needs a connection; after that, offline app starts work)
• Creating or joining farms
• All team administration (invitations, approvals, role changes, member removal)
• Approving or sending cross-farm requests (breeder, lineage, spit-off)
• Creating, editing, or deleting paddocks
• Creating, editing, deleting, or activating/deactivating points of interest
• Saving log entries
• Uploading your profile photo

The Sync Badge and "Waiting to Sync" Screen

When changes are waiting to be sent to the server, a cloud icon with a count appears in the Farm Home app bar. Tap it to open the Waiting to sync screen, where you can:

• See each queued change with its type and the animal or item it affects (e.g., "Update animal · Bella") — queued changes include animal creates and updates, paddock changes, lifecycle events, and profile updates
• Check its status: "Waiting" (queued), "Syncing…" (being sent), or "Failed" with a readable error message
• Retry a failed change — it's re-queued and attempted immediately
• Discard a change you no longer want to sync — a confirmation dialog warns that the change will be permanently removed
• Sync now (icon in the app bar) to trigger an immediate sync attempt

The badge disappears automatically once everything has synced. Changes also sync automatically whenever your connection returns — no action needed.

Offline Indicators

• Cloud icon in the app bar shows online/offline status
• Orange banners appear on screens that need internet
• Messages explain when an action requires a connection

Troubleshooting

Signing In

Can't sign in?

• Check your internet connection — signing in (and the security check) requires being online
• Ensure you're using the correct email address and password
• If you just signed up, verify your email first — open the verification email and confirm your account
• Use "Forgot password?" to reset your password (enter your email address first)

Sign up button stays disabled?

• You must check the Terms of Service / Privacy Policy checkbox
• Make sure both password fields match and the password is at least 6 characters

App stuck on the loading spinner at startup?

• Restoring your session needs an internet connection the first time you sign in on a device — check your network (later launches start straight away, even offline)
• If it persists, restart the app

Farms and Teams

Not seeing a farm?

• A newly created farm can take a moment (1-2 seconds) to appear
• Your join request may still be pending — the admin must approve it
• Your role may have been changed or you may have been removed from the farm

Invitation code not working?

• The code must be exactly 8 characters (check the counter under the field)
• Codes expire after 7 days — ask the admin for a new one
• "You are already a member of this farm" means exactly that — check your farm list

Can't invite team members or process requests?

• Only admins can manage the team
• All administrative actions require an internet connection

Can't remove a member?

• You cannot remove the last admin, and you cannot remove yourself

Animals and Logs

Animal changes show "Saved offline"?

• That's normal when offline — the change is queued and syncs automatically. Tap the cloud badge on the Farm Home Screen to see its status

A queued change failed?

• Open the Waiting to sync screen, read the error, and tap Retry — or Discard the change if it's no longer wanted

Can't edit or delete a log?

• Admins can edit any log; creators can only edit their own logs within 24 hours of creation

Recorded a sale/death log but the animal's status didn't change?

• A manually created lifecycle log entry doesn't change status — use the three-dot menu on the Animal Details Screen to record the sale, death, or purchase

Unknown animals appearing under "Pedigree"?

• External animals appear there after cross-farm lineage approvals — they are referenced for lineage only

Parent shows "Pending approval"?

• The other farm's admin hasn't decided on your request yet. You can cancel the request from the animal's edit form

Paddocks and Points of Interest

No "New paddock" or "Add a point" button?

• Only admins can create paddocks (Map's object list) and points of interest (Map's "Add a point" button)

Occupancy count shown in red?

• The paddock holds more animals than its advisory capacity — move some animals or raise the capacity (the app never blocks over-capacity assignments)

Can't delete a paddock?

• The paddock still contains animals — remove or move them first

"Move selected" disabled?

• The farm has only one paddock — there's nowhere to move the animals; create another paddock first

"Offline mode" warning on a paddock or POI form?

• Creating, editing, and deleting paddocks and POIs (and the POI active toggle) require an internet connection — try again when online

"Change paddock" disabled on an animal?

• There's no possible destination: no paddocks exist, or the animal is already in the farm's only paddock

Notifications and Photos

Not receiving push notifications?

• Notifications about join and breeding requests go to farm admins; decisions go to the requester
• Check that the notification type is enabled in Profile → Preferences → Notifications — farm-activity types (births, animals added, sales and deaths, new team members) are off by default and must be switched on
• You're never notified about your own actions — that's by design
• Check that notifications are allowed for Alpaca Guru in your device settings

A notification is missing from the inbox?

• The inbox only mirrors notifications that were actually sent — disabled types never appear there
• The inbox keeps the 50 most recent notifications; older ones are trimmed automatically
• The bell badge counts unread items — the notification may already have been read on another device

Profile photo not updating?

• Photo upload requires an internet connection (the camera button is hidden offline)
• Check camera/photo permissions in your device settings
• Large photos may take a moment to process

Permissions

"You don't have permission"?

• Guests have read-only access and cannot add or edit data
• Only admins can manage the team, change an animal's status, record lifecycle events, and manage paddocks
• Ask an admin to change your role if you need more access

Getting Additional Help

If issues persist:

• Note the exact error message
• Document the steps to reproduce the issue
• Contact support with details

Tips for Success

• Log promptly: Record births, matings, and other events as soon as possible for accurate tracking
• Be descriptive: Include relevant details in log notes for future reference
• Group efficiency: Select multiple animals when logging group activities like vaccinations
• Keep identification current: Add ear tags and microchips right away — they make animals easy to find with search
• Set up your paddocks: Assign every animal to a paddock and set advisory capacities — the app warns you visually when a paddock is overfilled, and movement history is recorded automatically
• Use roles wisely: Give team members the role that matches their responsibilities, and review join requests promptly
• Protect invitation codes: Never share codes publicly — they grant access to your farm and expire after 7 days
• Going off-grid? The app keeps working offline — animal edits, paddock assignments, and lifecycle events queue up and sync automatically when you're back online
• Cross-farm records: Approval requests protect every farm's data — send them early so the other farm's admin can respond before you need the records
• Stay informed your way: Turn on the farm-activity notifications you care about (births are a favorite) in Profile → Preferences → Notifications, and use the bell's inbox to catch up after time away

---

Version 0.11.0

Last Updated: 2026-07-08

Alpaca Guru - Comprehensive Farm Management