diff --git a/README.md b/README.md
index 7486fb2..157bcb5 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,63 @@
 # awesome-open-source-robots
-A curated list of open source robots worldwide
+
+<h1 align="center">
+  <a href="https://adafruit.com">
+  <img width="600" src="https://github.com/adafruit/awesome-open-source-robots/blob/master/awesome.png" alt="Awesome Open Source Robots"></a><br>Awesome Open Source Robots
+</h1>
+
+[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
+
+> A curated list of awesome open source robots worldwide.
+
+[Adafruit IO is the easiest way to connect your project to the internet](https://io.adafruit.com). You can easily connect your project to Adafruit IO with your device-of-choice by using your programming language of choice (we have _lots_ of libraries) and control or monitor over the internet. Data stored with Adafruit IO is _yours_ to manage and control. You can download it all anytime and we will never sell or give it away to another company. It's great for getting started with the internet of things!
+
+
+## Contents
+
+- [Guides](#guides)
+- [Community](#community)
+- [Code](#code)
+- [Hardware](#hardware)
+- [News](#news)
+- [Social](#social)
+- [Events](#events)
+
+## Guides
+
+
+## Community
+
+
+
+## Code
+
+
+## Hardware
+
+
+
+
+
+## News
+
+- []() - description.
+
+
+## Social
+
+
+
+## Events
+
+
+## Contribute
+
+Contributions and suggestions are always welcome! Please make pull requests to modify Awesome Open Source Robots.
+
+## License
+
+[![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg)](https://creativecommons.org/publicdomain/zero/1.0/)
+
+Updated: June 24, 2025
+
+To the extent possible under law, the authors have waived all copyright and related or neighbouring rights to this work.