Total Database Size: 300+ animals (mammals, birds, reptiles, amphibians, fish, insects)
Taxonomy Breakdown:
• Mammals: 80 species (elephants, lions, dolphins, bats, kangaroos, etc.)
• Birds: 60 species (eagles, penguins, hummingbirds, owls, parrots, etc.)
• Reptiles: 40 species (snakes, crocodiles, turtles, lizards, etc.)
• Amphibians: 30 species (frogs, salamanders, newts, caecilians, etc.)
• Fish: 50 species (sharks, goldfish, clownfish, piranhas, etc.)
• Insects: 40 species (butterflies, beetles, ants, dragonflies, etc.)
Filter Capabilities:
• By Class: Select specific taxonomic groups (mammals-only, birds-only, etc.)
• By Habitat: Forest, Desert, Grassland, Mountain, Freshwater, Ocean, Urban, Polar
• By Continent: Africa, Asia, Europe, North America, South America, Oceania, Antarctica
Data Sources: IUCN Red List, Encyclopedia of Life (EOL), National Geographic database

Problem: Teacher shows 10 random animals on projector, students need to see the same list on their devices.
Solution: Seeded RNG (xmur3 + mulberry32 deterministic algorithm)
How It Works:
1. Without Seed: Each click generates different random animals (Math.random())
2. With Seed: Same seed = same animal sequence across all devices
• Example: Seed "Zoo2024" always produces: Lion → Penguin → Frog → Shark → Butterfly...
3. Classroom Mode: Enables seed + big display + auto-rotation
Technical Implementation:
const hash = xmur3(seed); // "Zoo2024" → 0x4a7f8e9b
const rng = mulberry32(hash()); // Deterministic 0-1 generator
const index = Math.floor(rng() * animals.length);
Use Cases:
• Quiz Sync: All students answer questions about the same 10 animals
• Debate Prep: Teams research the same animal for pro/con arguments
• Art Class: Everyone draws the same randomly selected animal
Share Link: Click "Share Link" → Copy URL with embedded seed → Students open link and see identical results

Current Version: No IUCN Red List filtering (planned for Pro version)
Workaround:
1. Generate 50 animals → Manually check IUCN status → Filter externally
2. Use continent filters as proxy (e.g., Antarctica → mostly non-endangered penguins/seals)
Planned Feature (Pro):
• IUCN Categories: Extinct in Wild, Critically Endangered, Endangered, Vulnerable, Near Threatened, Least Concern
• Filter UI: Dropdown "Conservation Status" → Select "Critically Endangered" → Only show 500 animals
• Educational Value: Students learn which animals need protection
Current Data Availability:
• 100% of database has IUCN status recorded (backend)
• Frontend filter UI pending (Q1 2026 roadmap)
Manual Workaround Example:
1. Set filters: Mammal + Africa + Count=20
2. Generate → Get: Lion, Elephant, Rhino, Giraffe...
3. Cross-check IUCN.org:
• Lion: Vulnerable (VU)
• African Elephant: Endangered (EN)
• Black Rhino: Critically Endangered (CR)
• Giraffe: Vulnerable (VU)

Algorithm: Fisher-Yates shuffle + sampling without replacement
Without Unique Mode (count=10):
• Possible output: Lion, Penguin, Lion, Shark, Lion, Frog, Penguin, Eagle, Lion, Dolphin
• 4× Lion duplicates (purely random sampling with replacement)
With Unique Mode (count=10):
• Guaranteed output: 10 different animals (no repeats)
• Implementation: Shuffle entire filtered array → Take first N animals
Edge Case Handling:
• Request > Available: User asks for 100 unique animals, but filter only matches 50
→ System returns all 50 available (with warning message: "Only 50 unique animals match your filters")
• Performance: Fisher-Yates shuffle is O(n) → Can handle 300+ animals in <5ms
Code Example:
function fisherYates(arr) {
for (let i = arr.length - 1; i > 0; i--) {
const j = Math.floor(Math.random() * (i + 1));
[arr[i], arr[j]] = [arr[j], arr[i]];
}
return arr;
}
const unique = fisherYates(filteredAnimals).slice(0, count);
Classroom Use Case:
• Teacher: "Everyone picks 1 unique animal from this list of 30"
• Unique mode ensures no two students get duplicate assignments

Habitat = Where the animal lives (ecological niche)
Continent = Geographic location (biogeography)
Examples:
1. Polar Bear:
• Habitat: Polar (ice/tundra)
• Continent: North America (Arctic Canada, Alaska)
2. Kangaroo:
• Habitat: Grassland
• Continent: Oceania (Australia)
3. Nile Crocodile:
• Habitat: Freshwater (rivers/lakes)
• Continent: Africa
Filter Combinations:
• Ocean + Africa → Great White Shark, African Penguin, Dugong
• Forest + South America → Jaguar, Macaw, Poison Dart Frog, Sloth
• Desert + Asia → Bactrian Camel, Fennec Fox, Monitor Lizard
• Mountain + Europe → Alpine Ibex, Golden Eagle, Chamois
Multi-Habitat Animals (tagged with primary habitat):
• Brown Bear: Forest (primary) + Mountain (secondary)
• Sea Otter: Ocean (primary) + Freshwater (rivers, secondary)
• Barn Owl: Grassland (primary) + Urban (adapts to cities)
Teaching Tip: Use dual filters to teach biogeography (why certain animals only exist in specific continent+habitat combinations)

Current Database: Living species only (extant animals)
Extinct Animals Excluded:
• Prehistoric: Dinosaurs (T-Rex, Velociraptor, Brachiosaurus)
• Recently Extinct: Dodo (1662), Passenger Pigeon (1914), Tasmanian Tiger (1936)
• Pleistocene Megafauna: Woolly Mammoth, Saber-Toothed Cat, Giant Ground Sloth
Rationale:
1. Educational Focus: Tool designed for living biodiversity (conservation awareness)
2. Data Accuracy: Habitat/continent filters don't apply to extinct species
3. IUCN Scope: Red List focuses on current conservation status
Planned Feature (Separate Tool):
• "Random Extinct Animal Generator" (dedicated database)
• Geological period filters: Triassic, Jurassic, Cretaceous, Pleistocene
• Extinction cause tags: Meteor impact, climate change, human hunting
Workaround for Extinct Animals:
• Living Relatives: Generate "Reptile" → Get crocodiles/turtles (dinosaur descendants)
• Near-Extinct: Filter "Critically Endangered" (when feature launches) → Vaquita, Javan Rhino, Amur Leopard
Educational Opportunity: Compare living vs. extinct animals (e.g., African Elephant vs. Woolly Mammoth)

Challenge: Many animals occupy 2-3 habitats (generalists vs. specialists)
Classification Rule: Each animal tagged with primary habitat (where species spends >50% of time)
Examples of Habitat Conflicts:
1. Hippopotamus:
• Habitat in database: Freshwater (primary)
• Reality: Also uses grassland for nighttime grazing
• Justification: 16+ hours/day in water (cooling/protection)
2. Grizzly Bear:
• Habitat in database: Forest (primary)
• Reality: Also forages in mountain meadows, riverbanks
• Justification: Dens in forests, primary food source (berries/roots) in forests
3. Emperor Penguin:
• Habitat in database: Polar (primary)
• Reality: Spends months in ocean hunting fish
• Justification: Breeds exclusively on Antarctic ice (not classified as "Ocean")
Multi-Tagging (Backend Data):
• Database stores: {"name":"Brown Bear", "habitats":["Forest","Mountain","Freshwater"]}
• Frontend filter uses: primary_habitat="Forest"
Future Enhancement:
• "Show animals in 2+ habitats" toggle
• Multi-select habitat filter (Forest AND Mountain → only animals in both)
Teaching Opportunity: Discuss animal adaptability (specialists like koala vs. generalists like crow)

Current Download: Generated results only (text file with selected animals)
Full Database Export: Not available in free version (data licensing restrictions)
What You Can Export Now:
1. Text File (.txt): Click "Download .txt" → Get plain text list
Lion
Penguin
Elephant
Shark
Butterfly
2. Copy to Clipboard: Click "Copy" → Paste to Excel/Google Sheets
3. Share Link: Click "Share Link" → URL with filters/seed encoded
Full Database Access (Pro/Research Version):
• Format: CSV, JSON, Excel (.xlsx)
• Fields: Name, Scientific Name, Class, Habitat(s), Continent(s), IUCN Status, Diet, Lifespan, Weight Range
• Pricing: $49/year (educational/research license) or $299/year (commercial license)
• Licensing: Data compiled from public sources (IUCN, EOL, NatGeo) with attribution requirements
Free Alternative for Researchers:
1. Use filters to generate 200 animals at a time (max count)
2. Download .txt files → Combine manually in spreadsheet
3. Repeat with different filter combinations to get full 300+ database
4. Estimated time: 30 minutes to compile full database
Academic Use: Contact [email protected] for free research license (requires .edu email + project description)