An evolutionary art engine that uses genetic algorithms to create unique digital artworks through natural selection. Experience the birth of digital life as abstract art evolves before your eyes!
🌟 New here? → START_HERE.md - Perfect introduction with guided pathways!
Primordial evolves populations of digital organisms (genomes) that represent abstract artworks. Each genome contains:
- Colors - Hue, saturation, lightness palettes
- Shapes - Circles, rectangles, triangles, lines, arcs
- Movements - Rotation, translation, pulsing animations
- Parameters - Complexity, symmetry, rhythm, density
Through tournament selection, crossover, and mutation, these genomes compete for survival based on aesthetic fitness criteria.
- START_HERE.md - New to Primordial? Perfect entry point! 🌟
- QUICK_START.md - Get running in 5 minutes ⚡
- FEATURES.md - Complete feature documentation
- PACKAGE_CONTENT.md - File manifest & project structure 📦
- README.md - Project overview (this file)
🧬 Evolution Engine - 5 fitness environments, multi-objective optimization, hall of fame system 🎨 Modern UI - Dark/light themes, loading screens, keyboard shortcuts, visual feedback
� Professional Export - PNG/SVG downloads, social media integration, batch archives
🎮 Interactive Controls - Manual breeding, parameter tuning, real-time environment switching
📊 Analytics - Evolution tracking, genome comparison, fitness visualization
📋 Complete Features Guide → - Detailed documentation of all capabilities
- Launch - Open
index.htmlin a modern browser - Evolve - Click "Auto-Evolve" or press SPACE
- Explore - Try different environments and themes
- Save - Press S (PNG) or V (SVG) to export art
⚡ Complete Quick Start Guide → - Get running in 5 minutes with step-by-step instructions, experiments, and pro tips!
Power up your evolution workflow with these handy shortcuts:
- SPACE - Evolve one generation
- R - Reset population
- S - Save best artwork as PNG
- V - Export best artwork as SVG
- T - Toggle dark/light theme
- A - Toggle auto evolution on/off
💡 Note: Shortcuts are disabled when typing in input fields
- Mutation Rate - Probability of random changes
- Population Size - Number of genomes per generation
- Elitism - Top N genomes guaranteed survival
- Tournament Size - Selection pressure strength
Each environment rewards different aesthetic qualities:
- Balanced - Rewards complexity, color harmony, and movement
- Symmetry - Prefers ordered, patterned compositions
- Chaos - Favors high complexity and unpredictability
- Minimalist - Simple, clean, zen aesthetics
- Organic - Flowing forms and natural color palettes
- Vanilla JavaScript (ES6+) - Clean, modern code architecture
- HTML5 Canvas - High-performance artwork rendering
- CSS3 Variables - Dynamic theming system
- Web Audio API - Sonification of evolution (optional)
- Chart.js - Real-time fitness visualization
- JSZip - Hall of Fame archive generation
- Tournament Selection - Competitive genome selection
- Single-Point Crossover - Genetic recombination
- Gaussian Mutation - Realistic evolutionary changes
- Elitism Preservation - Protect best performers
- Multi-Objective Fitness - Complex aesthetic evaluation
- CSS Custom Properties - Seamless dark/light theming
- LocalStorage - Persistent user preferences
- Keyboard Event Handling - Power user shortcuts
- SVG Generation - Vector graphics export
- Progressive Loading - Smooth initialization experience
- Responsive Design - Mobile-friendly interface
Rich, vibrant gradients with deep blacks create a dramatic canvas for evolution:
- Gradient background: Deep blue → Red → Gold
- Glass-morphism panels with blur effects
- High contrast for optimal viewing
Soft, pastel tones create a gentle, professional aesthetic:
- Gradient background: Light blue → Pink → Cream
- Semi-transparent white panels
- Easy on the eyes for extended use
- 🎨 Real-time Canvas - Watch genomes render as they evolve
- 📊 Evolution Charts - Track fitness progress over generations
- 🏆 Hall of Fame Gallery - Showcase of your best evolved art
- ⚡ Loading Animation - Beautiful spinner with progress updates
- 🔔 Keyboard Hints - Elegant notifications for user actions
Originally built in approximately 4 hours on a mobile device using HTML editor apps, Primordial has evolved into a sophisticated evolutionary art platform.
Recent Evolution (October 2025):
- Professional UI/UX enhancements
- Modern theme system implementation
- Advanced export capabilities
- Power user keyboard shortcuts
- Enhanced social media integration
Because sometimes the best projects come from boredom... and then grow into something beautiful.
"From chaos, beauty emerges through the power of digital evolution" 🧬✨