diff --git a/README.md b/README.md
index b60f916e4..70d8a9ed4 100644
--- a/README.md
+++ b/README.md
@@ -11,15 +11,15 @@
 <br />
 <p align="center">
   <a href="https://github.com/peterfriese/MakeItSo">
-    <img src="assets/logo/MakeItSo.png" alt="Logo">
+    <img src="assets/hero/repo-hero.png" alt="Logo">
   </a>
 
-  <h3 align="center">Make It So - Again!</h3>
+  <h1 align="center">Make It So - Again!</h1>
 
   <p align="center">
     This is the source code for <i>Make It So</i>, a sample app that demonstrates how to use Firebase in a SwiftUI app that runs on all (most) of Apple's platforms.
     <br />
-    <a href="https://github.com/peterfriese/MakeItSo"><strong>Explore the docs »</strong></a>
+    <a href="https://twitter.com/peterfriese/status/1453467058302291975"><strong>Follow along on Twitter as I code the app »</strong></a>
     <br />
     <br />
     <a href="https://github.com/peterfriese/MakeItSo/issues">Report Bug</a>
@@ -28,13 +28,21 @@
   </p>
 </p>
 
-## Where is the previous version?
-If you are interested in the previous version, you can find it in the [`previous`](https://github.com/peterfriese/MakeItSo/tree/previous) branch.
+# Getting started
 
-## Why a complete rewrite?
-Because both SwiftUI and Firebase have evolved quite a bit since I implemented the original version, and I wanted to create an up-to-date version without having to carry the baggage of the legacy version.
+This app requires a Firebase project, which you can create at no cost using the [Firebase Console](https://console.firebase.google.com). Here are the steps. For a more detailed description of how to add Firebase to an iOS project, refer to the [official Firebase docs for iOS and Apple's other platforms](https://firebase.google.com/docs/ios/setup).
 
-## About The Project
+1. Clone the repo
+1. Create a Firebase project
+2. Create a Cloud Firestore database in the new Firebase project ([link](https://console.firebase.google.com/project/_/firestore/))
+2. Enable Anonymous Authentication ([link](https://console.firebase.google.com/project/_/authentication/providers))
+1. Register the iOS app in the Firebase project
+1. Download the `GoogleService-Info.plist` file to the `code/frontend/Configuration/Firebase/Development` folder
+1. Open `MakeItSo.xcodeproj` in Xcode
+1. Select the `MakeItSo (iOS) DEV` target
+1. Run the app
+
+# About the project
 
 
 <!-- LICENSE -->
@@ -49,7 +57,6 @@ This is not an official Google product.
 
 <!-- CONTACT -->
 ## Contact
-
 Peter Friese - [@peterfriese](https://twitter.com/peterfriese)
 
 Project Link: [https://github.com/peterfriese/MakeItSo](https://github.com/peterfriese/MakeItSo)
@@ -58,14 +65,14 @@ Project Link: [https://github.com/peterfriese/MakeItSo](https://github.com/peter
 
 ## Acknowledgements
 
-* The application icon is based on [Check](https://thenounproject.com/term/check/1905028/) by [Robert Won](https://thenounproject.com/robertwon/) from the [Noun Project](https://thenounproject.com/)
+The application icon is based on [Check](https://thenounproject.com/term/check/1905028/) by [Robert Won](https://thenounproject.com/robertwon/) from the [Noun Project](https://thenounproject.com/)
 
 <!-- MARKDOWN LINKS & IMAGES -->
 <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
-[xcode-shield]: https://img.shields.io/badge/xcode-v11.4.1-blue
+[xcode-shield]: https://img.shields.io/badge/xcode-v13.3.1-blue
 [xcode-url]: https://developer.apple.com/xcode/
 
-[swift-shield]: https://img.shields.io/badge/swift-v5.2-%23fe4b2d
+[swift-shield]: https://img.shields.io/badge/swift-v5.5-%23fe4b2d
 [swift-url]: https://swift.org/
 
 [contributors-shield]: https://img.shields.io/github/contributors/peterfriese/MakeItSo.svg?style=flat-square
diff --git a/assets/hero/MakeItSo-Hero.key b/assets/hero/MakeItSo-Hero.key
new file mode 100755
index 000000000..e2fe3c925
Binary files /dev/null and b/assets/hero/MakeItSo-Hero.key differ
diff --git a/assets/hero/MakeItSo-Hero.png b/assets/hero/MakeItSo-Hero.png
new file mode 100644
index 000000000..d4232d135
Binary files /dev/null and b/assets/hero/MakeItSo-Hero.png differ
diff --git a/assets/hero/MakeItSo-Hero.rotato b/assets/hero/MakeItSo-Hero.rotato
new file mode 100644
index 000000000..daddd66f8
Binary files /dev/null and b/assets/hero/MakeItSo-Hero.rotato differ
diff --git a/assets/hero/repo-hero.png b/assets/hero/repo-hero.png
new file mode 100644
index 000000000..f7e46a7e2
Binary files /dev/null and b/assets/hero/repo-hero.png differ