Update

README.md

@@ -1,3 +1,40 @@
 # Scenarios
 
 A library supporting fast prototyping for iOS Projects.
+
+# Introduction
+
+## Challenges of mobile frontend development
+
+- Stories with multiple requirements.
+- Multiple stakeholders (backend devs, designers, QAs, PMs, SMs, Testers, CTO, CEO ….).
+- Multiple environments, configurations.
+- Working on multiple features in parallel.
+- Demonstrating multiple states for UI components.
+- Mobile app deployment is complicated.
+- Continuous delivery.
+
+![problem](Assets/problem.jpg)
+
+## Scenario-driven development
+
+- Scenarios is a system supporting continuously delivering of incremental updates for mobile app frontends.
+- Targeting early feedback loop from all stakeholders.
+- Avoiding the need to deliver multiple apps for different purposes.
+- Easing parallelism between feature teams.
+- Supporting automated tests.
+- Extensible, new types of scenarios can be created to accommodate different stakeholders: prototype scenario, design system scenario, accessibility scenario, etc ...
+
+![scenario](Assets/scenario.jpg)
+
+## Recommended modular architecture
+
+![architecture](Assets/architecture.jpg)
+
+# Getting Started
+
+Please check out the Sample project.
+
+# License
+
+MIT