Animals
An animal is the central entity. Almost everything else in the app — feedings, weighings, sales, Market listings — hangs off an animal record.
Identity
Each animal has a short code you pick (F1-23, BP-Mojo-01, whatever convention you use). The code is unique inside your space and is part of the animal's storefront address if you show it. You can rename it later — references inside the app update automatically, but a shared storefront link to the old code stops working.
The form also records how the sex was determined (visual, probed, popped, DNA), whether the animal is a proven breeder, and which 100% hets are proven (it has produced visual offspring). Buyers see these on Market.
Collection status is Not for sale or Holdback. "Listed", "Reserved" and "Sold" come from Market and Sales — you don't set them here.
The form also captures species, sex, hatch date, traits, parents (if known), maturity stage, and notes. Sex defaults to "unknown", which is fine for hatchlings — change it once you can vent or probe.
Availability
Each animal has one availability, shown as a badge everywhere it appears:
- Not for sale — in your collection, not listed (the default).
- Holdback — kept on purpose, usually for a breeding project.
- For sale — listed.
- Reserved — a buyer has a pending reservation.
- Sold and Dead — the animal has left the collection. Its record stays, but feedings, weighings and location are locked.
Changing availability
These you can do freely from the animal form:
- Not for sale ⇄ Holdback ⇄ For sale
These need explicit actions:
for_sale→reserved— via "Mark as Reserved" (creates a pending sale).reserved→for_sale— via "Cancel Sale" on the reservation.- any active state →
sold— via "Mark as Sold" (creates or completes the sale and clears location). - any active state →
dead— via "Mark as Dead" (records date and cause; clears location). A reserved animal needs its reservation cancelled first.
Restricted states
sold and dead are locked: state and location are immutable from the form, and activities (feedings, weighings, etc.) are disabled. The form, photos, and code are still editable so you can correct typos or add a final photo. Both have one escape hatch each:
- A
soldanimal reverts tofor_saleif you cancel the sale (the sale row stays as history, markedcancelled). - A
deadanimal reverts via the Revive action — clears the date of death and reactivates the record. Use this only for actual mistakes; the audit log keeps the history.
The reason both are restricted: once an animal is sold or dead, the data should describe the past, not be silently rewritten. The cancel/revive escape hatches handle the "I clicked the wrong button" case without removing accountability.
Location
Every active animal lives in either a tub on a rack or a cage — never both, never neither. When you mark an animal as sold or dead, the location is automatically cleared. See Housing for the rack/tub/cage model.
Maturity
hatchling, juvenile, sub_adult, adult — set manually on the animal. The app deliberately does not auto-compute maturity from age and weight: every breeder has slow-growing lines or power-fed individuals, and the rule that fits one collection breaks another. Set it yourself when the animal hits the milestone you care about.
Traits and morph
Traits are picked from the catalog. The form distinguishes expressed traits (the animal shows the morph) from confirmed hets (carrier, hidden). The morph string at the top of the animal page — and on your storefront — is computed from those: visual traits first, hets after, in canonical order. Saved hatchlings inherit traits from the calculator's predicted offspring, including het percentages and compound decompositions like BEL = Mojave + Lesser. See Genetics for the rules.