diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c66ce81
--- /dev/null
+++ b/README.md
@@ -0,0 +1,72 @@
+<img width="826" alt="substrate-logo" src="https://github.com/user-attachments/assets/064f6e10-126d-4ae7-acf1-2b7a0e363626">
+
+<div align="center">
+<img src="https://github.com/user-attachments/assets/338aec6e-cd7a-4d8b-935f-7d8a90a71b84" width="400" height="400"/>
+
+# `Substrate`
+
+![Static Badge](https://img.shields.io/badge/mission-visualize%20human%20progress-brightgreen)
+
+<br />
+![GitHub top language](https://img.shields.io/github/languages/top/human-substrate/Problems)
+![GitHub last commit](https://img.shields.io/github/last-commit/human-substrate/Problems)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+<p class="align center">
+<h4><code>Substrate</code> An Open-source Framework for Human Understanding, Meaning, and Progress.</h4>
+</p>
+
+[Introduction Video](#introduction-video-by-network-chuck) •
+[What and Why](#what-and-why) •
+[Philosophy](#philosophy) •
+[Quickstart](#quickstart) •
+[Structure](#structure) •
+[Examples](#examples) •
+[Custom Patterns](#custom-patterns) •
+[Helper Apps](#helper-apps) •
+[Examples](#examples) •
+[Meta](#meta)
+
+</div>
+
+## Navigation
+
+- [About](#about)
+- [How to Add Problems](#how-to-add-problems)
+- [Meta](#meta)
+
+## About
+
+To start, first go read the full blog post on the project, located here.
+
+[Introducing Substrate](https://danielmiessler.com/p/introducing-substrate)
+
+## How to Add Problems
+
+You can add Problems to Substrate by submitting PRs to this repo.
+
+We're working on a web-based interface for this as well to make it easier for non-coders to contribute.
+
+<br />
+
+> [!NOTE]
+> July 16, 2024 — Please contribute PRs to this README as you see fit.
+
+
+## Meta
+
+> [!NOTE]
+> Special thanks to the following people for their inspiration and contributions!
+
+- _Jonathan Dunn_ for being the person most similar in goals that I've met so far.
+- _Joel Parish_ for a neverending source of inspiration and structure wisdom.
+- _Joseph Thacker_ a constant flow of solid ideas about all aspects of the project.
+
+### Primary contributors
+
+<a href="https://github.com/xssdoctor"><img src="https://avatars.githubusercontent.com/u/9218431?v=4" title="Jonathan Dunn" width="50" height="50"></a>
+
+`Substrate` was created by <a href="https://danielmiessler.com/subscribe" target="_blank">Daniel Miessler</a> in July of 2024.
+<br /><br />
+<a href="https://twitter.com/intent/user?screen_name=danielmiessler">![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/danielmiessler)</a>
+