Skip to content

DeadxxSmile/ReptiLogic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐍 ReptiLogic

A desktop application for reptile breeders and collectors to manage their animals, track breeding seasons, calculate offspring genetics, and monitor animal health β€” all stored locally on your machine.

View Screenshots at Our Website

Release License: GPL-3.0 Platform


πŸ“¦ Installation

Download the latest installer from the Releases page.

  1. Download ReptiLogic-Setup-1.1.1.exe
  2. Run the installer β€” choose your install location and create shortcuts
  3. Launch ReptiLogic β€” the first-run wizard will guide you through setup

No additional software required.


✨ Features

🐍 Collection

  • Track animals with photos, morphs, weight, DOB, acquisition info, and notes
  • Auto-generated Animal IDs (e.g. BPF042-AhA) or enter your own to match an existing system
  • Grid and list view with filtering by species, sex, status, and search
  • Full animal history β€” breeding records, weight log, feeding log, photo gallery
  • Link parents at time of adding β€” lineage builds automatically over time
  • Clickable family tree on the Lineage tab, going back as many generations as recorded
  • Bulk import from CSV (Settings β†’ Import)

πŸ₯ Health

  • Per-animal health dashboard with weight trend chart
  • Log health issues with category and severity, track medications, record vet visits
  • Dashboard reminders for animals overdue on feeding or weighing

πŸ₯š Breeding

  • Full pairing lifecycle: Planned β†’ Active β†’ Gravid β†’ Laid β†’ Hatched
  • Terminology adapts for live-birth species (Born instead of Hatched, etc.)
  • Log clutches with egg count, incubation details, and individual offspring records
  • Add Babies Wizard β€” step through each hatchling, assign name/sex/weight/morphs/ID, add them all to your collection at once with parents auto-linked
  • Suggested Pairings β€” scans your active collection and recommends pairings based on genetics

🧬 Genetics Calculator

  • Full Punnett square engine: recessive, co-dominant, dominant, line-bred, and sex-linked
  • Allele complex support β€” BEL complex (Lesser, Butter, Mojave, Phantom, Mystic, Russo, Special, Mocha), Yellow Belly complex, 8-Ball complex, Bearded Dragon Scale complex, and more. Two alleles from the same complex automatically produce the correct result (e.g. Lesser Γ— Mojave = BEL)
  • Sex-linked Banana/Coral Glow β€” Male Maker and Female Maker inheritance modelled correctly (~93% sex ratio skew). Maker type stored per animal and used automatically in From Collection mode
  • Outcome cards showing morph name, probability, expected clutch count range, and sex ratio notes
  • Clutch size projection based on species typical range
  • Health warnings for all morphs with known concerns
  • Use animals from your collection or enter genes manually

πŸ“– Morph Library

  • Ball Python β€” 130+ morphs with full allele groups, health concerns, sex-linked Banana/Coral Glow
  • Western Hognose β€” 25+ morphs with corrected inheritance types (Anaconda = incomplete dominant, Toffee Belly = incomplete dominant, Lavender = recessive, Pastel RBE = dominant)
  • Leopard Gecko β€” 18 morphs including all three non-allelic albino strains (Tremper, Bell, Rainwater), Mack Snow, Giant, Enigma and Lemon Frost with ethical health warnings
  • Bearded Dragon β€” 14 morphs including Leatherback/Silkback (health flagged), Dunner, Zero, Witblits, American Smoothie
  • Add custom morphs for any species β€” included in the calculator automatically

πŸ–¨οΈ Husbandry Print Reports

  • Professional print-ready document from any animal's detail page
  • Animal photo, morphs, 2-generation lineage pedigree, weight log, feeding history
  • Breeder header with name, logo, website, and social links (Instagram, X, YouTube, TikTok, Facebook)

πŸ’Ύ Backup & Data

  • Automatic compressed ZIP backups on app open or close, configurable retention and folder
  • One-click restore from any saved backup
  • Export collection, breeding records, and morphs to CSV
  • CSV import with auto format detection

βš™οΈ Settings

  • Breeder profile with logo and social links (used in print reports)
  • Auto-generate or manual Animal IDs
  • Light and dark mode
  • Configurable feeding and weighing reminder thresholds
  • Move database to any folder (OneDrive, Dropbox, etc.)

🧭 First-Run Wizard

5-step setup covering database location and automatic backup configuration. All settings adjustable later.


πŸ› οΈ Building from Source

Prerequisites

  • Node.js 22 or 24 LTS β€” https://nodejs.org
  • Visual Studio 2022 with the "Desktop development with C++" workload

Setup

git clone https://github.com/DeadxxSmile/reptilogic.git
cd reptilogic
npm install
npm start

Build the installer

npm run build

Output: dist/ReptiLogic-Setup-1.1.1.exe

Scripts

Command Description
npm start Run in development mode
npm run build Build distributable installer
npm run rebuild Recompile native modules
npm run clean Wipe build artifacts and node_modules

πŸ“ Project Structure

reptilogic/
β”œβ”€β”€ dev/                         ← Dev tools and scripts (not shipped)
β”œβ”€β”€ pages/                       ← GitHub Pages / reptilogic.com website
β”œβ”€β”€ resources/
β”‚   β”œβ”€β”€ art/                     ← App icons
β”‚   β”œβ”€β”€ screenshots/             ← Screenshots for README and website
β”‚   └── templates/               ← CSV import template
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ index.jsx                ← React entry + router
β”‚   β”œβ”€β”€ main/                    ← Electron main process
β”‚   β”‚   β”œβ”€β”€ main.js
β”‚   β”‚   β”œβ”€β”€ preload.js
β”‚   β”‚   β”œβ”€β”€ database/
β”‚   β”‚   β”‚   β”œβ”€β”€ db.js            ← SQLite init + auto-migration runner
β”‚   β”‚   β”‚   └── migrations/      ← SQL files applied in order on launch
β”‚   β”‚   β”œβ”€β”€ genetics/
β”‚   β”‚   β”‚   └── calculator.js    ← Punnett square + allele complex engine
β”‚   β”‚   └── ipc/                 ← IPC handlers by domain
β”‚   └── renderer/                ← React frontend
β”‚       β”œβ”€β”€ App.jsx
β”‚       β”œβ”€β”€ pages/
β”‚       β”œβ”€β”€ components/
β”‚       β”œβ”€β”€ hooks/
β”‚       β”œβ”€β”€ utils/
β”‚       └── styles/
└── public/

πŸ—ΊοΈ Roadmap

  • reptilogic.com landing page
  • Mobile companion / local network web access
  • Breeding season calendar view
  • Additional species morph databases (corn snake, boa)
  • Sale and customer tracking
  • Weight chart image export

πŸ–₯️ Tech Stack

Desktop shell Electron 41
Frontend React 18 + Vite 7
Routing React Router 6
Database SQLite via better-sqlite3
Packaging electron-builder 26

πŸ“„ License

GNU GPL-3.0 β€” see LICENSE for details.

⚠️ Disclaimer

Provided AS IS without warranty of any kind.


⚠️ v1.1.0 users: A database migration bug in v1.1.0 could cause startup failures on some systems. Please upgrade to v1.1.1. See the release notes for details.

About

ReptiLogic is an offline Electron/SQLite desktop app for reptile breeders. Securely track husbandry, feedings, and clutches on your machine. Features an advanced Punnett square genetics calculator supporting all inheritance types, plus a built-in database of 150+ Ball Python and Western Hognose morphs. Keep your data local.

Resources

License

GPL-3.0, GPL-3.0 licenses found

Licenses found

GPL-3.0
LICENSE
GPL-3.0
LICENSE.txt

Stars

Watchers

Forks

Packages

 
 
 

Contributors