No commit activity in last 3 years
No release in over 3 years
A live reload command line tool written in ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

>= 1.0.0
~> 0.9.2
 Project Readme

RoadRunner

What is?

RoadRunner is a simple, but powerful, live reload tool totally written in Ruby. Though RoadRunner was made in Ruby, it is language-agnostic, in simple words: you can use RoadRunner with ANY language or platform (or operating system) in your back-end. You just need ruby installed.

Usage

  1. Run:
sudo gem install roadrunner-live-reload
  1. Create a roadrunner.yml file in the root folder of your project by running the command roadrunner setup.

Your file structure will look like this:

config:
  polling_interval: 0.1
  change_check_strategy: modification_time #You also can use 'checksum'
  live_reload_port: 9876
  web_server_port: 9875
  files: [
           ["/relative/path/to/some/css-file.css", "/relative/path/in/your/web-server.css"],
           "/equivalent/path.css"
         ]

If the relative path for a file to be monitored in your project folder structure is equal to its URL in web server, you just have to add this path (relative to the root folder) to the "files" collection.

  files: [
           "/same/path.css",
           ...
         ]

But if the paths are different, you can map it easily:

  files: [
           ["/relative/path/to/some/css-file.css", "/relative/path/in/your/web-server.css"],
           ...
         ]
  1. RoadRunner also starts a tiny web server to serve the roadrunner.js script file. So, add a reference to this file in your application layout/template/master page.
<script src="http://localhost:9875/roadrunner.js"></script>
  1. Open a terminal, "cd" to your project root folder (where roadrunner.yml is located) and run:
roadrunner
  1. Open your application in your browser

License

This code is free to use under the terms of the MIT license