Skip to content

Latest commit

ย 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงฌ biolab-interactive

Learn Cell Biology interactively, visually, and enjoyably.

HTML5 CSS3 JavaScript License


โœจ Features

๐Ÿ”ฌ Explorer Mode

  • Interactive SVG cell with realistic organelles and gradients
  • Animal/Plant toggle - switch between cell types (cell wall, chloroplasts, central vacuole)
  • Detailed organelle information - function, structure, fun facts, and memory cards
  • Progress tracking - monitors which organelles you've explored

๐ŸŽฎ Quiz Mode (20 Questions)

  • 20 questions organized by categories: Organelles, Membrane, Transport, Cytoskeleton, Cell Types
  • Scoring system with streak bonus points
  • Topic filtering - practice only what you need to review
  • Immediate feedback with educational explanations
  • Final results with medals and badges

๐Ÿ—๏ธ Builder Mode

  • Build your own cell by adding organelles one by one
  • Realistic visuals - each organelle has its own shape, color, and details (mitochondrial cristae, ribosomes on RER, etc.)
  • Hint system to guide users
  • Celebration upon completion

โš–๏ธ Compare Mode

  • Comparative table of Prokaryotic vs. Eukaryotic cells
  • SVG visualization of relative sizes
  • 11 characteristics compared point by point

๐Ÿ“š Topics Covered

Topic Content
๐Ÿง  Nucleus Nuclear envelope, chromatin, nucleolus
โšก Mitochondria Double membrane, cristae, mitochondrial DNA
๐Ÿญ Ribosomes Subunits, rRNA, protein synthesis
๐Ÿ•ธ๏ธ Rough ER Attached ribosomes, protein synthesis
๐Ÿงˆ Smooth ER Lipids, detoxification, calcium storage
๐Ÿ“ฆ Golgi Apparatus Cisternae, vesicles, packaging
๐Ÿ›ก๏ธ Plasma Membrane Fluid mosaic, phospholipids, proteins
๐Ÿฆด Cytoskeleton Microfilaments, intermediate filaments, microtubules
๐Ÿš› Cellular Transport Passive, active transport, endo/exocytosis
๐ŸŒฟ Chloroplast Photosynthesis, thylakoids, chlorophyll
๐Ÿฆ  Prokaryote vs. Eukaryote Structural and functional differences

๐Ÿš€ Installation & Usage

Option 1: Download and open locally

# Clone the repository
git clone https://github.com/Bredalis/biolab-interactive.git

# Enter the directory
cd biolab-interactive

# Open in browser (macOS)
open index.html

# Or on Linux
xdg-open index.html

# Or on Windows
start index.html

Option 2: Local server (recommended)

# With Python 3
cd biolab-interactive
python -m http.server 8000

# Visit http://localhost:8000
# With Node.js
npx serve .

# With PHP
php -S localhost:8000

Option 3: Deploy to GitHub Pages

  1. Push the repo to GitHub
  2. Go to Settings โ†’ Pages
  3. Select the main branch and / (root) folder
  4. Your app will be at https://Bredalis.github.io/biolab-interactive/

Option 4: Deploy to Netlify/Vercel

# Drag the folder to https://app.netlify.com/drop
# Or use Vercel CLI:
npx vercel --prod

๐Ÿ“ Project Structure

biolab-interactive/
โ”œโ”€โ”€ index.html          # Main page (semantic HTML)
โ”œโ”€โ”€ styles.css          # Complete styles (modern CSS with variables)
โ”œโ”€โ”€ app.js              # Application logic (vanilla JS)
โ”œโ”€โ”€ assets/             # Images and additional resources
โ”œโ”€โ”€ README.md           # This file
โ””โ”€โ”€ LICENSE             # MIT License

๐Ÿ› ๏ธ Technologies

  • HTML5 โ€” Semantic structure and interactive SVG
  • CSS3 โ€” CSS Variables, Grid, Flexbox, animations, responsive design
  • JavaScript (ES6+) โ€” Vanilla JS, no external dependencies
  • SVG โ€” Scalable vector graphics with gradients and animations
  • Google Fonts โ€” Nunito typeface for readability

๐ŸŽฏ Roadmap

  • Flashcard study mode (Anki-style cards)
  • Vesicular transport animations (RER โ†’ Golgi โ†’ membrane)
  • "Day in the life of a cell" simulation
  • Multilingual support (English, Portuguese)
  • PWA (Progressive Web App) for mobile installation
  • AR mode with WebXR for 3D cell visualization

๐Ÿค Contributing

Contributions are welcome! If you find a bug or have an idea:

  1. Fork the repository
  2. Create a branch (git checkout -b feature/new-feature)
  3. Commit your changes (git commit -am 'Add new feature')
  4. Push to the branch (git push origin feature/new-feature)
  5. Open a Pull Request

๐Ÿ“œ License

This project is licensed under the MIT License. You may use, modify, and distribute it freely for educational purposes.

MIT License

Copyright (c) 2026 biolab-interactive

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

๐Ÿ’œ Acknowledgments

Made with love for biology students around the world. ๐ŸŒธ

"The cell is the unit of life, and understanding it is understanding ourselves."


โญ If you like this project, give it a star on GitHub!


๐Ÿท๏ธ GitHub Topics

Add these to your repository's "Topics" section: biology, education, interactive, svg, javascript, cell-biology, organelles, quiz, learning, html5, css3, science, students, elearning, biology-education

About

๐Ÿ”ฌ Interactive cell biology explorer โ€” tap organelles, take quizzes, and build your own cell. ๐Ÿงฌ

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages