Project

rail

0.0
No commit activity in last 3 years
No release in over 3 years
A light framework for front-end development closely following the conventions of Ruby on Rails.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 2.14
~> 3.4

Runtime

~> 4.0
~> 1.6
~> 11.2
~> 3.4
~> 3.0
 Project Readme

Rail Version Dependency Status Build Status

A light framework for front-end development inspired by Rails. The sole purpose of Rail is to compile assets, and it includes the following components:

Installation

Straightforward

Install the gem:

gem install rail

Create a new project:

rail new my_project

Run Bundler:

cd ./my_project
bundle

Run the server:

rake server

Open http://localhost:3000 in your browser, see “My Project,” and enjoy.

Under the hood, the rail new my_project command creates a new folder in the current directory called my_project and initializes a basic Rail project inside that folder. In this case, MyProject is used as the class name of the project. Feel free to replace my_project with the name of your project.

Manual

Create a Gemfile:

source 'https://rubygems.org'

gem 'rail'

Run Bundler:

bundle

Create three files: config/application.rb, config.ru, and Rakefile. In config/application.rb:

require 'bundler'
Bundler.require(:default)

module MyProject
  class Application < Rail::Application
  end
end

In config.ru:

require_relative 'config/application'

run MyProject::Application.new

In Rakefile:

require_relative 'config/application'

MyProject::Application.load_tasks

Feel free to replace MyProject with the name of your project.

Usage

Rail closely follows Rails. If you know Rails, you already know Rail.

Structure

Organize your code according to the following convention:

  • app/assets/javascripts for scripts,
  • app/assets/stylesheets for styles,
  • app/views for templates,
  • app/helpers for helper modules, and
  • public for other static content.

The templates in app/views/layouts have a special purpose. First, application.html.haml is used for rendering the root of your application (both / and /index.html). Second, any template in layouts is used as a layout for the templates in the subfolder of views that has the same name as the layout. For example, articles/what-is-the-meaning-of-life.html.haml will be rendered in the context of layouts/articles.html.haml provided that the latter has a placeholder for the former via the yield keyword.

Configuration

As with Rails, Rail is configured inside config/application.rb:

module MyProject
  class Application < Rail::Application
    # Gems to look for additional assets
    config.gems << 'googleplus-reader'

    # Assets to precompile when running `rake assets`
    config.precompile << 'application.css'
    config.precompile << 'application.js'
    config.precompile << 'index.html'

    # Compress assets when serving and precompiling
    config.compress = true
  end
end

If config.compress is not specified, it is implicitly set to ENV['RAIL_ENV'] == 'production'.

Commands

Run Rake to see the available tasks:

rake -T
rake assets  # Precompile assets
rake server  # Start server

rake server starts up a Web server; if none is specified in Gemfile, WEBrick will be fired up.

rake assets compiles your assets and stores them in public. You should explicitly tell Rail what to compile as it was shown in the previous section. Note that the server will try to serve from public first, so make sure you delete the precompiled files when you change your code in app.

Examples

Additional usage examples can be found here, here, and here.

Contribution

  1. Fork the project.
  2. Implement your idea.
  3. Open a pull request.