improve docs and change index setup for `localhost`