diff --git a/Ball.xcodeproj/project.xcworkspace/xcuserdata/nateparrott.xcuserdatad/UserInterfaceState.xcuserstate b/Ball.xcodeproj/project.xcworkspace/xcuserdata/nateparrott.xcuserdatad/UserInterfaceState.xcuserstate
index fa2e28d..37ae2b8 100644
Binary files a/Ball.xcodeproj/project.xcworkspace/xcuserdata/nateparrott.xcuserdatad/UserInterfaceState.xcuserstate and b/Ball.xcodeproj/project.xcworkspace/xcuserdata/nateparrott.xcuserdatad/UserInterfaceState.xcuserstate differ
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ef13ceb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+![Screen recording of a ball bouncing](Recording.gif)
+
+# Ball
+
+It's a little ball that lives in your dock. You can drag it and it'll bounce around the screen. You can also swipe on it with two fingers. It comes in red. You can flick it, bounce it, try to make it hit the corner, see how many times it can bounce, count how many times it hits the wall, and more. It's a ball. It's fun. It's a ball.
+
+## Credits
+
+It's inspired by [Nate Heagy's](https://heagy.com/) widget for the OS X Dashboard, which I remember fondly because someone put it on our class [eMac](https://en.wikipedia.org/wiki/EMac) in fifth grade. It was a lot bouncier and come in more colors, but it didn't go in the dock!
+
+Credit also goes to Wessley Roche, who made this [little Gist](https://gist.github.com/wonderbit/c8896ff429a858021a7623f312dcdbf9) explaining how to get the position of the dock. I've [extended this](https://github.com/nate-parrott/ball/blob/main/Ball/DockUtils.swift#L65) to try to estimate the position of the app's dock icon when it's clicked, so the ball can animate out of it. 
+
+## Final words
+
+I hope you enjoy this little ball.
diff --git a/Recording.gif b/Recording.gif
new file mode 100644
index 0000000..3e8a2b1
Binary files /dev/null and b/Recording.gif differ