diff --git a/README.md b/README.md
index 72cc5749..ea367914 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
Like this project ? Leave us a star ⭐ or join us in the discussions 💬
-
+
@@ -26,41 +26,100 @@
-
+
+
+
+
+
-
- Open-source alternative to Chargebee, Metronome, Orb, Stripe Billing, made for scale and extensibility !
-
+
+
----
+Meteroid addresses the complexities and limitations of traditional billing systems, particularly for businesses transitioning to usage-based models or product-led-growth principles.
+It eliminates the gap between customer usage and billing, ensuring accuracy and transparency.
-
-
- ⚠️ Meteroid is in ALPHA
-
- Not all feature are finished, and the API is not stable.
-
-
-
- We are working fulltime on our first stable release, and on improving our DX and UX.
+
+---
+
+
+
+ Talk to us !
+
-# Developer Guide
+
+
+
+## How It Works
+
+Meteroid integrates with your existing systems via a simple API, collecting data on customer usage and interactions.
+This data fuels the Meteroid billing engine, applying your custom pricing models to generate accurate, timely invoices.
+
+Our platform simplifies the creation, scaling and maintenance of complex billing models, automates invoice generation, and provides *clear, actionable insights* for achieving your KPIs.
+
+
+
+
+
+
+
+## For whom ?
+
+Meteroid is designed for startups, SMEs, and enterprises looking to embrace some form of usage-based billing or product-led growth.
+
+## Build for Sustainable Growth
+
+Our philosophy is deeply rooted in the principles of open source and open startup culture.
+We believe in **transparency** and **collaboration** as foundational pillars that not only foster innovation but also build trust and community around our mission.
+
+By choosing Rust as our core technology, we leverage its efficiency, reliability, and safety features, ensuring our platform is built on a solid, secure foundation.
+
+Our focus on Product-Led Growth (PLG) reflects our commitment to creating products that drive user acquisition, retention, and expansion through their inherent value and user experience
+
+This approach, combined with our open philosophy, guides us toward creating a more inclusive, sustainable future for the SaaS industries.
+
+
+## Developer Guide
+
+> [!WARNING]
+>
+> Meteroid is in **ALPHA**, and is to be considered unstable.
+>
+> We are working fulltime on a stable release.
+
Please refer to the [contributing guide](CONTRIBUTING.md) for how to install Meteroid from sources.
+
+## License
+
+Copyright 2024 Meteroid
+
+Licensed under the AGPL V3 License.
See [LICENSE.md](LICENSE.md) for more information.
+
+## Contributors ✨
+
+
+
+
+
+
diff --git a/assets/meteroid-schema-4.webp b/assets/meteroid-schema-4.webp
new file mode 100644
index 00000000..e31a3d10
Binary files /dev/null and b/assets/meteroid-schema-4.webp differ