diff --git a/images/AllSpiceMotto.png b/images/AllSpiceMotto.png
new file mode 100644
index 0000000..4721ee5
Binary files /dev/null and b/images/AllSpiceMotto.png differ
diff --git a/images/integrations-icon.png b/images/integrations-icon.png
new file mode 100644
index 0000000..5ddcc33
Binary files /dev/null and b/images/integrations-icon.png differ
diff --git a/readme.md b/readme.md
index 504b454..31ec756 100644
--- a/readme.md
+++ b/readme.md
@@ -1,11 +1,42 @@
-![new repo](./images/new_repo.png)
+# AllSpice Demos Home
 
-# Welcome
+Welcome! This is our demos home. We have some great projects that will help you understand how your team can use AllSpice and its benefits.
 
-Welcome to your new repo. This is your readme.md file.
+## Getting started
+These are the best projects to start using AllSpice. We have a basic demo for each of the ECAD tools that we currently support. Feel free to deep dive into the one that fits your team.
+
+#### ![ ](https://img.shields.io/badge/-Altium-EEBF3F?labelColor=gray&style=flat&logo=altiumdesigner&link=https://www.altium.com) [Archimajor 3D Printer](https://hub.allspice.io/AllSpice-demos/Altium-demo)
+Our Altium demo uses the Archimajor 3D printer driver board.
+
+#### ![ ](https://img.shields.io/badge/-KiCAD-4183C4?labelColor=gray&style=flat&logo=kicad&link=https://www.kicad.org) [Arduino UNO](https://hub.allspice.io/AllSpice-demos/KiCAD-Demo) 
+A clone of the well known Arduino UNO, a microcontroller board based on the ATmega328P designed in KiCAD. 
+
+#### ![ ](https://img.shields.io/badge/-OrCAD-E35B5B?labelColor=gray&style=flat&link=https://www.cadence.com/en_US/home/tools/pcb-design-and-analysis/orcad.html) [Raspbery Pi Pico 2040 ](https://hub.allspice.io/AllSpice-Demos/OrCAD-Demo)
+The beagle fire board, an open hardware single-board computer (SBC) powered by the PolarFire microchip MPFS025T.
+
+## Actions demo
+<a href="https://hub.allspice.io/AllSpice-Demos/Actions-Demo"><img width="300px" src="https://hub.allspice.io/AllSpice-Demos/Actions-Demo/media/branch/main/images/actions-logo.png"></a>
+
+Visit the [Actions demo](https://hub.allspice.io/AllSpice-Demos/Actions-Demo) repo to learn how to get started and get the most out of AllSpice Actions.
+
+## Library management demo
+
+Our [Library management](https://hub.allspice.io/AllSpice-Demos/Altium-Library-Demo) demo repo shows how to view and perform design reviews on your symbol and footprint library files.
+
+<a href="https://hub.allspice.io/AllSpice-Demos/Altium-Library-Demo"><img width="300px" src="https://hub.allspice.io/AllSpice-Demos/Altium-Library-Demo/media/branch/main/images/book-shelf.png"></a>
+
+## Integrations demo
+
+<img align="left" width="80" src="./images/integrations-icon.png">
+
+Your team can also integrate AllSpice with other tools! 
+<br>
+<br>
+Check out the [integrations demo](https://hub.allspice.io/AllSpice-Demos/Integrations) to learn more 
 
 
-## You can edit this file and add information and specifications about your project
-
- - [ ]  1 pA accuracy
- - [ ]  weight < 2.5 kg
+## Documentation
+For a deep dive explanation on how Allspice works, go to our [Docs](https://learn.allspice.io). Our top suggestions to start are:
+ - [Git 101](https://learn.allspice.io/docs/git-101)
+ - [AllSpice Crash Course](https://learn.allspice.io/docs/allspice-crash-course)
+ - [Design review and merging guide](https://learn.allspice.io/docs/design-reviews-and-merging)