docs: update readme

Author: chetan

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020 Pixelcop Research, Inc.
+Copyright (c) 2021 Pixelcop Research, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,6 +1,6 @@
 # vproxy
 
-> Zero-config virtual proxies with TLS
+> Zero-config virtual proxies with TLS, for local development
 
 Automatically create and manage hosts files and TLS certificates for any
 hostname using a locally-trusted CA (via
@@ -18,50 +18,68 @@ brew install vproxy
 or manually:
 
 1. Install [mkcert](https://github.com/FiloSottile/mkcert/#installation)
-2. Build it:
+2. Download a [pre-built binary](https://github.com/jittering/vproxy/releases) or build it from source:
 
 ```sh
 go get github.com/jittering/vproxy/...
 ```
 
+### Initialize mkcert
+
+Create install a new local-CA in your system:
+
+```sh
+mkcert -install
+```
+
 ## Usage
 
 vproxy consists of two processes: daemon and client.
 
 * The __daemon__ serves as the primary host of the HTTP & HTTPS endpoints for
   your various applications.
 * The __client__ registers a service with the daemon and relays all access logs
-  to the current terminal.
+  to the current terminal. It can also optionally run the service for you.
+
+A single daemon is required per-host, while clients can be run multiple times.
 
 ### daemon
 
-A single daemon is required per-host:
+If installed via homebrew on macOS, running it as a service is easy:
 
 ```sh
-$ vproxy daemon
-[*] rerunning with sudo
-Password:
-[*] starting proxy: http://127.0.0.1:80
-[*] starting proxy: https://127.0.0.1:443
+sudo brew services start vproxy
 ```
 
-Note that *sudo* is required to bind to privileged ports.
+> Note that you must run as root to bind to privileged ports (hence the use of
+> sudo above).
 
-Alternatively, run it as a homebrew service (macOS only), so it will start
-automatically:
+Or run it manually:
 
 ```sh
-sudo brew services start vproxy
+$ vproxy daemon
+[*] rerunning with sudo
+Password:
+[*] starting proxy: http://127.0.0.1:80
+[*] starting proxy: https://127.0.0.1:443
 ```
 
 ### client
 
+Use the client to bind a hostname to a local port:
+
 ```sh
 $ vproxy client --bind foo.local.com:5000
 [*] registering vhost: foo.local.com:5000
 ```
 
-You can even run the underlying service directly, for ease of use:
+The daemon will automatically:
+
+* Issue a TLS cert for `foo.local.com`
+* Add `foo.local.com` to your hosts file (e.g., /etc/hosts)
+* Add a reverse proxy vhost connecting `foo.local.com` to port 5000
+
+You can even run the underlying service with one command, for ease of use:
 
 ```sh
 $ vproxy client --bind foo.local.com:5000 -- flask run
@@ -76,10 +94,12 @@ $ vproxy client --bind foo.local.com:5000 -- flask run
 ```
 
 Now visit https://foo.local.com/ to access your application originally running
-on http://127.0.0.1:8080
+on http://127.0.0.1:5000
+
+When you stop the client process (i.e., by pressing `^C`), vproxy will deregister the vhost with the daemon and send a TERM signal to it's child process.
 
 ## License
 
-MIT, (c) 2020, Pixelcop Research, Inc.
+MIT, (c) 2021, Pixelcop Research, Inc.
 
 Originally based on [simpleproxy](https://github.com/ybrs/simpleproxy) - MIT (c) 2016 aybars badur.