diff --git a/README.md b/README.md
index 54665fd47..1ed64493d 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
# LBRY App - https://lbry.tv
+
This repo contains the UI code that powers the official LBRY desktop app, as well as lbry.tv. The LBRY app is a graphical browser for the decentralized content marketplace provided by the
[LBRY](https://lbry.com) protocol. It is essentially the
[lbry daemon](https://github.com/lbryio/lbry) bundled with a UI using
@@ -23,10 +24,11 @@ This repo contains the UI code that powers the official LBRY desktop app, as wel
+
+
+
-
-
![App GIF](https://spee.ch/@lbrynews:0/lbry-joule.gif)
## Table of Contents
@@ -100,20 +102,23 @@ You can run the web version (lbry.tv), the electron app, or both at the same tim
- This uses webpack-dev-server and includes hot-reloading. If you want to debug the [web server we use in production](https://github.com/lbryio/lbry-desktop/blob/master/src/platforms/web/server.js) you can run `yarn dev:web-server`. This starts a server at `localhost:1337` and does not include hot reloading.
-
#### Customize the web app
- Enter web directory, copy .env.defaults to .env and make changes
+
```
cd web
cp .env.defaults .env
nano .env
```
-- If you want to customize the homepage content
+
+- If you want to customize the homepage content
+
1. add `CUSTOM_HOMEPAGE=true` to the 'web/.env' file
2. copy `/custom/homepage.example.js` to `/custom/homepage.js` and make desired changes to `homepage.js`
- If you want up to two custom sidebar links
+
```
PINNED_URI_1=@someurl#2/someclaim#4
PINNED_LABEL_1=Linktext
@@ -124,11 +129,11 @@ PINNED_LABEL_2=OtherLinkText
- Finally `NODE_ENV=production yarn compile:web` to rebuild
-#### Deploy the web app (*experimental*)
+#### Deploy the web app (_experimental_)
1. Create a server with a domain name and a reverse proxy https to port 1337.
2. Install pm2, node v10, yarn
-3. Clone this repo
+3. Clone this repo
4. Make any customizations as above
5. Run `yarn` to install
6. Run `NODE_ENV=production yarn compile:web` to build