diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# rebindable
+
+[![Hackage Status](https://img.shields.io/hackage/v/rebindable.svg)](https://hackage.haskell.org/package/rebindable)
+
+A library to facilitate rebinding of syntax.
+
+## Example:
+
+```haskell
+{-# LANGUAGE RebindableSyntax #-}
+{-# LANGUAGE RecordWildCards #-}
+
+module Example where
+
+import Control.Monad.Indexed
+import Control.Monad.Indexed.State
+import Control.Monad.Indexed.Trans
+import Control.Monad.IO.Class
+import Prelude
+
+import qualified Language.Haskell.Rebindable as Use
+import Data.Default
+
+foo :: IxStateT IO String Int ()
+foo = let Use.IxMonad{..} = def in do
+  ilift . liftIO . print =<< iget
+
+  imodify (length)
+  ilift . liftIO . print =<< iget
+```
diff --git a/rebindable.cabal b/rebindable.cabal
--- a/rebindable.cabal
+++ b/rebindable.cabal
@@ -3,7 +3,7 @@
 -- see: https://github.com/sol/hpack
 
 name:           rebindable
-version:        0.1.1
+version:        0.1.2
 synopsis:       A library to facilitate rebinding of Haskell syntax
 description:    A library to facilitate rebinding of Haskell syntax
 category:       Syntax
@@ -14,6 +14,9 @@
 license:        MIT
 build-type:     Simple
 cabal-version:  >= 1.10
+
+extra-source-files:
+    README.md
 
 source-repository head
   type: git