Getting started

The five tabs

Add your first pet

PathOverview “+” → Add Pet

1. Enter a name and select a species. Search by Chinese name, English name, or trait, or filter by category.
2. Optionally enter morph, sex, source, and purchase price.
3. Add acquired date, birth date, current weight, and current length. Units follow Settings → Unit System.
4. Assign an existing enclosure or choose Not Assigned and create one later.
5. Configure feeding, water-change, and cleaning schedules independently in interval or cycle mode.
6. Tap Save. Initial weight and length values also become growth records.

Add an enclosure

PathOverview “+” → Add Enclosure

1. Enter its name, type, and dimensions.
2. Optionally assign a pet and configure heating, UVB, and day/night temperature and humidity targets.
3. Save it for environment readings, maintenance, supply replacement, and grouped care.

Overview and daily care

View another date

PathOverview → date strip → select a date

A content marker means that date contains care, medication, or follow-up items. Selecting a date refreshes the care card, including future plans.

Complete care items

PathOverview → care card → Daily Care

1. The summary shows total, pending, completed, and affected pets.
2. Tap the circle to complete a simple item. Open the form first when you need food, amount, photos, or an exception.
3. Use the date button for another day and the edit button to add or adjust items.

Maintenance and growth

Maintenance shows days until equipment service, such as UVB replacement. Growth highlights recent weight or length changes. Tap a card to open the related enclosure or pet.

Pet profiles

Find and arrange pets

PathPets → top-left Sort / Filter

• Sort by custom order, name, date added, or care status. Adjust Custom Order lets you drag every pet into place.
• Filter by pets/enclosures and status.
• Switch between two-column cards and a compact list without changing the stored profiles.

Edit a profile

PathPets → choose a pet → Edit

1. Tap the portrait to take or choose a photo, then drag and zoom in the crop screen.
2. Choose automatic, preset, or custom card color. The three choices are mutually exclusive.
3. Edit identity, source, purchase, status, enclosure, dates, measurements, and notes.
4. Physiological Fasting / Brumation lowers the weight of missed-feeding alerts; it is not medical advice.
5. Edit the three schedules independently and tap Done.

View keeping cost

PathPets → choose a pet → Keeping Cost

The total includes purchase price and priced food, medication, or substrate consumed by the pet or its enclosure. A cost appears only when an inventory item has a price and is deducted through a record.

Care records and batch actions

Quick record

PathOverview “+” → choose a record type

Record feeding, weight, shedding, waste, water, cleaning, environment readings, or supply use/replacement. You can also long-press a pet card for pet-specific quick actions.

Record feeding

Path“+” → Feeding

1. Select pet and time.
2. Select prey and freely record count, portion, grams, or milliliters. Total prey weight is optional.
3. Choose normal feeding, assisted feeding, refusal, or regurgitation.
4. For inventory deduction, select a compatible item and mark Consumed, Returned, or Discarded.
5. Add supplements, notes, or photos and save.

Batch care

PathOverview “+” → Batch Care

1. Choose feeding, water, or cleaning and group by enclosure or species.
2. For feeding, choose prey, unit, per-pet amount, and optional inventory.
3. Check only the pets included in this batch.
4. Set each outcome to Done, Refused, Skipped, or Abnormal, then Submit.

Enclosures and environment

Open an enclosure

PathPets → Enclosure filter → choose an enclosure

The detail view combines dimensions, pets, equipment, target ranges, recent readings, and maintenance. Reassigning a pet updates both sides of the relationship.

Add an environment reading

PathOverview “+” → Environment Reading, or Pet/Enclosure → Environment

1. Select enclosure, date, and time.
2. Enter temperature, humidity, and optional notes.
3. Save to update trends, then compare readings with your target range and the animal’s actual condition.

History

PathHistory tab

1. Newest dates and newest records within a day appear first.
2. Use the date button; dates without content are disabled.
3. Use Filter or Return to Today.
4. Open a record for details and editing, or mark it complete/incomplete from its menu.
5. Terria asks for confirmation before deleting a record. Deleted records do not move to a trash folder; linked inventory is restored when possible. Export a complete backup first if you need a recoverable copy.

Supplies, inventory, and cost

Add an item

PathSupplies → “+”

1. Choose Food, Medication, Substrate, or Equipment and enter a name.
2. Enter purchase quantity and unit, such as two bags, one box, or one bottle.
3. For consumables, enter content per purchase unit and choose count, portion, grams, or milliliters.
4. Add purchase price to calculate cost from actual consumption.
5. Optionally enable low-stock alerts, enclosure association, and replacement period.

Use or replace supplies

PathOverview “+” → Use / Replace Supplies

1. Select the item and actual amount.
2. Choose a pet or enclosure. A pet assigned to an enclosure resolves to that enclosure and its pets.
3. Substrate use can refresh replacement state. Insufficient stock or a save error rolls back the whole operation.

Inventory ledger

PathSupplies → Manage beside an item

Use Consume Supplies for real use with a required target. Use Other Entry for restock, disposal, or count correction. The ledger retains quantity, unit, time, relationships, and rollback state.

Professional records

PathPets → choose a pet → Professional Records

Reminders and attention items

Enable reminders

PathSettings → Care Reminders

Enable Daily Care Reminders, select a time, then configure feeding, water, cleaning, medication-dose, and follow-up reminders. iOS notification permission is required.

Attention thresholds

PathSettings → Professional Tools → Attention Thresholds

Thresholds control weight, environment, and missed-feeding alerts. Notifications can be delayed by system conditions, so inspect animals and habitats directly every day.

Personalization, language, and units

Personalization

PathSettings → Personalization

• Choose System, Light, or Dark appearance.
• Choose a preset accent or use the system color picker at the end of the palette.
• Control accent-tinted backgrounds and light background presets.
• Turn colored sex symbols on or off.
• Choose and crop a 16:9 home status-card image. This background remains local and is not uploaded by personal iCloud Sync.

Language and units

PathSettings → Language / Unit System

Follow the system or choose Simplified Chinese, Traditional Chinese, English, Japanese, Korean, Spanish, Russian, or Thai. Unit System changes weight, length, and temperature input and display without rewriting the meaning of stored records.

iCloud Sync

PathSettings → Data Management → iCloud Sync

1. Enable iCloud Sync. It is off on a new install; sign in to iCloud and allow Terria access first.
2. Personal sync covers pet profiles, care and professional records, tasks, environment, supplies, and inventory data.
3. Personal sync includes only a lightweight thumbnail of each pet’s current avatar. Record attachments, captured originals, and home status-card backgrounds are no longer uploaded. The separate photo-sync switch has been removed; attachments uploaded by older versions are cleaned from the private iCloud space when the upgraded app syncs.
4. Tap Sync Now, or let Terria sync when launched, foregrounded, or after a successful local save.
5. Work offline normally. On reconnect, items merge individually; the latest modification wins for the same item.

Backup, restore, and export

Complete backup

PathSettings → Data Management → Export Complete Backup (ZIP)

The ZIP contains profiles, care logs, and linked original images. It is created locally, then shared to Files, AirDrop, or a destination you choose.

Automatic backup

PathSettings → Data Management → Scheduled Automatic Backup

Enable it and select the interval. Settings shows the latest result or failure. Keep an additional copy in a location you trust.

Restore

PathSettings → Data Management → Restore from Backup

1. Select a Terria ZIP package or legacy JSON archive.
2. Review the summary. Restore replaces current local data and photos.
3. Confirm Replace and Restore. Terria first makes a local safety copy, validates references, and then restores.

CSV and PDF

• CSV: Settings → Data Management → Export Detailed Spreadsheet.
• PDF: Settings → Data Management → Generate Monthly Care Report.

Terria Pro and purchases

PathSettings → Terria Pro

The free tier supports up to three active pets. Basic profiles, care, reminders, and backups are not deleted when Pro is inactive. Apple supplies current plans, localized prices, currency, and availability.

• Select a plan and tap Unlock Terria Pro to use Apple In-App Purchase.
• Tap Restore Purchases when a prior entitlement is missing.
• Subscribers can open Apple’s subscription management sheet from the Pro page.
• Lifetime does not renew. Current Pro benefits do not include any future AI service or usage.

Deletion and backup recovery

Delete a pet

PathPets → choose a pet → Edit → Delete This Pet Profile

This is a high-impact action that also handles related care and photos. Export a complete backup first.

Restore from a backup

PathSettings → Data Management → Import & Export → Restore from Backup

Terria does not provide a trash folder. To recover deleted content, select a ZIP backup exported before deletion or a legacy JSON archive. Terria creates a safety rollback copy before importing.

Delete the app

Deleting Terria removes its local app-space data. Exported files and content in the private iCloud database do not necessarily disappear with the local app.

Troubleshooting