diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5cd6da4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+# Zeppelin Basil _(basil)_
+
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+> Sample Dapp built on top of ZeppelinOS
+
+This project presents a basic contract `Basil.sol` and then uses `zos` to upgrade the contract to `BasilERC721.sol` using a proxy that preserves the original contract's state, while mutating its logic. The upgraded contract also makes use of ZeppelinOS' on-chain standard library, connecting to a proxy of the `MintableERC721Token` implementation of the `openzeppelin-zos` release.
+
+As for functionality, the Dapp allows users to change the light color of a Basil plant, using an Arduino and an RGB wifi light bulb. The upgraded contract also emits an ERC721 non fungible token to the user.
+
+Please see [docs.zeppelinos.org](https://docs.zeppelinos.org/docs/basil.html) for information.
+
+## Install
+
+To execute the app locally, run:
+
+```
+npm install && npx truffle compile && npm start
+```
+
+This will start a dev sever at `localhost:3000`. The application will connect to the ropsten network and link to a deployed version of Basil.
+
+## Usage
+
+Install the MetaMask extension on your browser and open `localhost:3000`. Make sure that your account is unlocked and pointing to the ropsten network.
+
+## Develop
+
+To execute the app locally on the development network, first set the value of `ACTIVE_NETWORK` in `src/js/constants.js` to `config.networks.development`.
+
+Then, run the same commands from the install section.
+
+Next, start the ganache personal blockchain with:
+
+```
+ganache-cli --deterministic
+```
+
+Finally, deploy the contracts to this blockchain running:
+
+```
+npm run deploy
+```
+
+If you have problems with an account not being recognized, change the used account address in `package.json`'s deploy script.
diff --git a/readme.md b/readme.md
deleted file mode 100644
index 4f79d97..0000000
--- a/readme.md
+++ /dev/null
@@ -1,21 +0,0 @@
-## Zeppelin Basil
-
-This is a sample Dapp built on top of *ZOS* (ZeppelinOS). It presents a basic contract `Basil.sol` and then uses an `AppManager` from ZOS to upgrade the contract to `BasilERC721.sol` using a proxy that preserves the original contract's state, while mutating its logic. The upgraded contract also makes use of ZOS' on-chain standard library, connecting to a proxy of the `MintableERC721Token` implementation of the `openzeppelin-zos` release.
-
-As for functionality, the Dapp allows users to change the light color of a Basil plant, using an Arduino and an RGB wifi light bulb. The upgraded contract also emits an ERC721 non fungible token to the user.
-
-Please see [docs.zeppelinos.org](https://docs.zeppelinos.org/docs/basil.html) for information.
-
-### Running the app locally
-
-```
-npm install && npx truffle compile && npm start
-```
-
-This will start a dev sever at `localhost:3000`. The application will connect to the ropsten network and link to a deployed version of `Basil.sol`. Make sure you're running metamask, that it is unlocked and pointing to the ropsten network.
-
-### Running the app locally, on the development network
-
-Same as "Running the spp locally" but modify `ACTIVE_NETWORK` in `src/js/constants.js` to `config.networks.development`.
-
-Then start `ganache-cli --deterministic` and run `npm run deploy`. This will run the contracts deployment script on the local network. If you have problems with an account not being recognized, change the used account address in `package.json`'s deploy script.