diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f69838c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# Cozy Discovery: Uncover Hidden Gems on the Fediverse
+
+Welcome to Cozy Discovery, a pioneering project that brings the power of the decentralized social platform, Fediverse, directly into [cozy.pub](https;//cozy.pub). We're excited to introduce an aggregated explore API that reveals what's trending in the Fediverse, so you can discover new and interesting articles with ease.
+
+## **What is Cozy Discovery?**
+
+Our mission is simple: empower users to explore the vast, decentralized social space of the Fediverse. Our API aggregates data from various platforms, providing a comprehensive view of popularly shared articles within any given day. Whether you're a curious reader or an editor looking for inspiration, Cozy Discovery has got you covered.
+
+## **Key Features**
+
+### 1. **Trending Articles**
+
+Get instant access to the most talked-about articles on the Fediverse. Our API fetches and updates daily data, ensuring you stay up-to-date with what's trending.
+
+### 2. **Decentralized Power**
+
+Unlike traditional social media platforms, Cozy Discovery is built on a decentralized architecture. This means your data remains private and secure.
+
+### 3. **Easy Integration**
+
+Our explore API is designed to be easily integrated into any application or website. Whether you're building the next big thing or just want to add a touch of Fediverse flair to your cozy reader, we've got you covered.
+
+## **Technical Details**
+
+- Data aggregation and processing using Python and SQL
+- API endpoints for easy integration (more details coming soon)
+- Compatible with various programming languages and frameworks
+
+## **Why Cozy Discovery?**
+
+By leveraging the power of the Fediverse, we're bringing users closer to the content they care about. Our platform empowers readers, writers, and editors alike to engage with a vibrant, decentralized community.
+
+## **Join the Journey!**
+
+Stay updated on our progress by following us on the Fediverse:
+
+- [Your Mastodon instance](https://your-mastodon-instance.com/@cozydiscovery)
+- [Your Diaspora account](https://diasporafoundation.org/accounts/your-diaspora-account)
+
+## **Get Involved!**
+
+We're always looking for passionate contributors to join our mission. Whether you have expertise in data science, development, or design, we'd love to hear from you!
+
+[![Contribute to Cozy Discovery](https://example.com/contribute-button.png "Join the fun!")](CONTRIBUTING.md)
+
+## **License**
+
+Cozy Discovery is released under the [MIT License](LICENSE).
+
+## **Acknowledgments**
+
+Special thanks to our founding team and contributors for their hard work and dedication. We're excited to have you on board!
+
+[![Cozy.pub Team](https://example.com/cozy-pub-team.png "Meet the team!")](https://cozy.pub/team)
+
+Stay cozy, stay curious!