diff --git a/README.md b/README.md
index 7c92752..909e2cd 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,24 @@
-# <custom-element> element
+# <typing-effect> element
 
-Boilerplate for creating a custom element.
+A custom element that shows text as if it were being typed
 
 ## Installation
 
 ```
-$ npm install @github/custom-element-element
+$ npm install @github/typing-effect-element
 ```
 
 ## Usage
 
 ```js
-import '@github/custom-element-element'
+import '@github/typing-effect-element'
 ```
 
 ```html
-<custom-element></custom-element>
+<typing-effect data-lines='["Welcome to GitHub!", "Let’s begin the adventure"]'>
+  <span data-target="typing-effect.content"></span>
+  <span data-target="typing-effect.cursor">|</span>
+</typing-effect>
 ```
 
 ## Browser support