diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# desert
+
+[![Build Status](https://travis-ci.org/zjhmale/desert.svg?branch=master)](https://travis-ci.org/zjhmale/desert)
+[![Hackage](https://img.shields.io/hackage/v/desert.svg)](https://hackage.haskell.org/package/desert)
+[![Hackage-Deps](https://img.shields.io/hackage-deps/v/idrigen.svg)](https://hackage.haskell.org/package/desert)
+
+## Acknowledgement
+
+well, this project aims to make developing with OCaml projects painless. it is still in early stage, so currently just for self usage.
+
+## Install
+
+```
+cabal install desert
+```
+
+## Usage
+
+* create project
+
+```
+desert new NAME
+```
+
+* build
+
+```
+desert build
+```
+
+* run
+
+```
+desert run
+```
+
+* test
+
+```
+desert test
+```
+
+* clean
+
+```
+desert clean
+```
+
+## Screenshot
+
+![cleantha](./screenshot.gif)
+
+## License
+
+Copyright © 2016 zjhmale
+
+Distributed under the [![license BSD](https://img.shields.io/badge/license-BSD-orange.svg)](https://en.wikipedia.org/wiki/BSD_licenses)
diff --git a/desert.cabal b/desert.cabal
--- a/desert.cabal
+++ b/desert.cabal
@@ -1,7 +1,7 @@
 name:                desert
-version:             0.1.0.1
+version:             0.1.0.3
 synopsis:            a simple build tool for OCaml projects
-description:         Please see README.md
+description:         Check out <https://github.com/zjhmale/desert#readme the readme> for documentation.
 homepage:            https://github.com/zjhmale/desert
 license:             BSD3
 license-file:        LICENSE
@@ -12,6 +12,8 @@
 build-type:          Simple
 -- extra-source-files:
 cabal-version:       >=1.10
+extra-source-files:
+    README.md
 
 library
   hs-source-dirs:      src