Project

rails-frontend

0.0
No commit activity in last 3 years
No release in over 3 years
rails-frontendmickey/rails-frontendHomepageDocumentationSource CodeBug TrackerWiki
Build a static frontend app with rails
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
13,694
Stars
1
Forks
0
Watchers
2
 Releases
Current version
0.1.4
Total releases
5
First release
2014-05-04
Latest release
2014-05-06
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2014-05-05
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.0
jeweler
~> 2.0.1
rdoc
~> 3.12
shoulda
>= 0
simplecov
>= 0

Runtime

activesupport
= 4.1.0
clamp
>= 0
tilt
>= 0
 Project Readme

Rails Frontend

Build a static frontend app with rails.

Why ?

This was built after experiencing some frustrations with a 400 lines Gruntfile. I wanted a framework to build static website with the following requirements:

  • templating
  • preprocessors
  • minifying
  • can build a static website
  • dependency management
  • live reload

It appears Rails has most of this, a lot of goodies and it's very mature. A few parts were missing:

  • build a static website: I added this via a simple rake task doing a wget (:trollface:)
  • dependency management:
    • Rails comes with bundler
    • I added bower support to easily handle javascript/css dependencies (it's integrated into the rails assets pipeline)
  • live reload: I added guard in the Gemfile and a basic Guardfile to handle most of my use cases.

I gave a talk about this at Paris.rb and will link to the slides ASAP.

Requirements

bower: To install it please go to the bower homepage.

wget: To install:

  • Ubuntu: installed by default
  • Archlinux: should be installed if not pacman -S wget
  • OSX: brew install wget

Overview

To generate a new rails-frontend app:

gem install rails-frontend
rails-frontend new webapp

To launch a development server with LiveReload:

guard start

To build the static website:

rake dist

Your website, including all assets will be copied in dist/.

You should know

This is a prototype coded for a talk I gave at paris.rb. If you're crazy adventurous enough to test this, please take the tiem to give me some feedback.

Contributing to rails-frontend

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Commit and push until you are happy with your contribution.
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2014 Michael Bensoussan. See LICENSE.txt for further details.