rack-livereload/README.md

42 lines
1.2 KiB
Markdown
Raw Normal View History

2011-11-04 15:51:22 +00:00
Hey, you've got [LiveReload](http://www.livereload.com/) in my [Rack](http://rack.rubyforge.org/)!
No need for browser extensions anymore! Just plug it in your middleware stack and go!
Use this with [guard-livereload](http://github.com/guard/guard-livereload) for maximum fun!
## Using in...
### Rails
In `config/initializers/development.rb`:
``` ruby
MyApp::Application.configure do
config.middleware.insert_before(Rack::Lock, Rack::LiveReload)
end
```
### config.ru/Sinatra
``` ruby
require 'rack-livereload'
use Rack::LiveReload
```
## How it works
The necessary `script` tag to bring in a vendored copy of [livereload.js](https://github.com/livereload/livereload-js) is
injected right before the closing `head` tag in any `text/html` pages that come through. The `script` tag is built in
such a way that the `HTTP_HOST` is used as the LiveReload host, so you can connect from external machines (say, to
`mycomputer:3000` instead of `localhost:3000`) and as long as the LiveReload port is accessible from the external machine,
you'll connect and be LiveReloading away!
## To-do
* Specify the `port`
* Override the `host`
* Change the reload delays
As usual, super-alpha!