Added 🎉 #

Core Simulator Engine #

• Added interactive learning simulator framework
• Added virtual experiment support
• Added scenario-based learning system
• Added decision-making engine
• Added result evaluation system
• Added learning progress tracking

---

Added Models #

Created core data models:

• Experiment

  • Experiment title
  • Description
  • Difficulty level

• Scenario

  • Learning question
  • Multiple decision options

• Decision

  • Decision text
  • Correct/incorrect validation
  • Custom scoring points

• SimulationResult

  • Final score
  • Completion status

---

Added Controller #

Added:

SimulatorController

Features:

• Score management
• Progress calculation
• Decision submission
• State updates
• Simulation reset

---

Added Widgets #

New reusable Flutter widgets:

ExperimentCard #

Displays:

• Experiment information
• Difficulty level

ScenarioView #

Provides:

• Question display
• Decision options
• User interaction

DecisionButton #

Reusable action button component.

SimulatorProgress #

Provides:

• Learning progress visualization
• Completion tracking

---

Added Screen #

Added:

SimulatorScreen

Includes:

• Complete simulator UI
• Scenario handling
• Score display
• Progress indicator

---

Architecture Improvements #

Implemented:

• Clean package structure
• Separation of models, controllers, widgets, and screens
• Provider-based state management
• Reusable Flutter components

---

Testing #

Added tests for:

• Decision model validation
• Score calculation
• Progress updates
• Decision submission logic
• Widget interaction

---

Documentation #

Added:

• Complete README documentation
• Installation guide
• Usage examples
• Architecture overview
• Contribution guidelines
• GPL-3.0 license information

---

Developer Information #

Created by:

Sufyan bin Uzayr

Open-source developer building educational and developer-focused tools.

Website:

https://sufyanism.com/

---

Zeba Academy #

Learning platform for:

• Coding
• Technology
• Development
• Practical projects

Website:

https://zeba.academy/

Resources:

https://code.zeba.academy/

---

Future Releases 🚀 #

Upcoming features:

• AI powered learning scenarios
• Advanced animations
• Interactive experiment builder
• Offline progress storage
• Cloud synchronization
• Analytics dashboard
• Achievement badges
• Certificates
• Multiplayer simulations

---

[0.0.1]: Initial release