diff --git a/README.md b/README.md
index 02f9539..fb69394 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,98 @@
-# Expansion Cards
-Reference designs and documentation to create Expansion Cards for the Framework Laptop.
-The Framework Laptop's Expansion Card system lets you choose exactly the ports you want
-and which side you want them on. We've built USB-C, USB-A, HDMI, DP, MicroSD, and Storage
-Expansion Cards, but there is an entire world of other interesting ways to extend the
-capabilities of a notebook. We're releasing CAD to make it easy for you to develop your
-own Expansion Cards.
-Check out the Expansion Card section of the Framework Community for card ideas, support,
-or just to show off what you're working on: https://community.frame.work/c/expansion-cards/developer-program/90
+# Expansion Cards [![Badge License]][License]
-To apply for funding for prototype fabrication or to list your Expansion Card on the
-Framework Marketplace, fill out the form here: https://forms.gle/uaP9kWxwcK5VZNuA8
+***[Framework]'s*** *Reference Design & Documentation.*
-**Beta Release:** Note that these are early design releases, so you should build and test
-development versions before committing a design based on this CAD to mass production.
+
+
+
-
+
+
+[![Button PCB]][PCB]
+[![Button Housing]][Housing]
+[![Button Cards]][Cards]
+
+
+
+
+---
+
+![Badge Beta]
+
+*These are early design releases, so you should build and test development*
+*versions before committing a design based on this CAD to mass production.*
+
+---
+
+
+
+
+
+
+
+
+
+
+The **Framework Laptop**'s **Expansion Card** system
+allows you to choose exactly what ports you want
+and on what side they should be.
+
+
+
+So far, we have built `USB-C` , `USB-A` , `HDMI` , `DP` ,
+`MicroSD` cards, as well as a `Storage Expansion` .
+
+
+
+However, there are so many more interesting and
+useful ways to extend the capabilities of notebooks.
+
+
+
+We have released the **CAD** files to make it easier
+for you to develop your
+own **Expansion Cards**.
+
+
+
+
+
+## Funding & Listing
+
+Please fill out the **[Form]** if you want to:
+- Apply for funding of prototype fabrication
+- List your Expansion Card on the Framework Marketplace
+
+
+
+
+
+
+[Framework]: https://frame.work/
+[Cards]: https://community.frame.work/c/developer-program/expansion-card/90
+[Form]: https://forms.gle/uaP9kWxwcK5VZNuA8
+
+[Housing]: Mechanical/README.md
+[License]: LICENSE 'This repository is under the Creative Commons 4.0 BY license'
+[PCB]: Electrical/README.md
+
+
+
+
+[Badge License]: https://img.shields.io/badge/-BY-ae6c18.svg?style=for-the-badge&labelColor=EF9421&logoColor=white&logo=CreativeCommons
+[Badge Beta]: https://img.shields.io/badge/Beta_Release-yellow.svg?style=for-the-badge
+
+
+
+
+[Button Housing]: https://img.shields.io/badge/Housing-gray?style=for-the-badge&logoColor=white&logo=SemanticWeb
+[Button Cards]: https://img.shields.io/badge/Cards-4490dd?style=for-the-badge&logoColor=white&logo=ROS
+[Button PCB]: https://img.shields.io/badge/PCB-37a779?style=for-the-badge&logoColor=white&logo=ElasticStack
-## License
-Expansion Cards © 2021 by Framework Computer Inc is licensed under CC BY 4.0.
-To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/