Skip to content
The spicy feature toggle framework for Rails
Ruby CSS JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Have you ever wanted to test out a new feature on only a subset of users? Did that implementation end up being lots of if/else statements embedded in the main code? If so, Chili can help.

Chili is built on top of Rails Engines and Deface and allows you to conditionally add new/modify existing views, while leaving the main code untouched.


Install Chili on your system (not in your app!):

gem install chili


Just like engines chili extensions are like mini apps that are created separately from the main app using the "chili" command.

Creating a new chili extension

Assuming you want to add a new extension that adds exposes a new social feature such as a "like" button feature to a subset of users, first run:

chili social # social is the name of the extension

This is basically a shortcut for running the rails plugin new engine generator with a custom template and will:

  1. Create a directory named chili_social containing the basic structure for the extension
  2. Clone the app you are adding the extension to as a submodule into chili_social/main_app
  3. Add a reference to the extensions gemspec to the main app gemfile for testing

Define who can see the extension

Use the active_if block to control whether new controllers/overrides are visible or not. The context of the active_if block is the application controller so you can use any methods available to that.

# lib/chili_social.rb
module ChiliSocial
  extend Chili::Activatable
  active_if { logged_in? && current_user.admin? } # Extension is only visible to logged in admin users

Modifying view templates in main app

Chili uses deface to modify existing view templates (see deface docs for details) Add overrides to the app/overides directory mirroing the path of the view you want to modify. For example, assuming the main app has the partial app/views/posts/_post.html.erb:

<% # app/overrides/posts/_post/like_button.html.erb.deface (folder should mirror main app view path) %>
<!-- insert_bottom 'tr' -->
<td><%= link_to 'Like!', chili_social.likes_path(like: {post_id: post}), method: :post %></td>

Adding new resources

Use rails g scaffold Like as usual when using engines. The new resource will be namespaced to ChiliSocial::Like and automounted in the main app at /chili/social/likes, but only accessible when active_if is true. All the rules for using engine-based models apply.

Modifying existing models

Create a model with the same name as the one you want to modify: rails g model User --migration=false and inherit from the original:

# app/model/chili_social/user.rb
module ChiliSocial
  class User < ::User
    has_many :likes

Access through the namespaced model:

<%= ChiliSocial::User.first.likes %>
<%= current_user.becomes(ChiliSocial::User).likes %>

Adding new stylesheets/javascripts

Add files as usual in app/assets/chili_social/javascripts|stylesheets and inject them into the layout using an override:

<% # app/overrides/layouts/application/assets.html.erb.deface %>
<!-- insert_bottom 'head' -->
<%= stylesheet_link_tag 'chili_social/application' %>
<%= javascript_include_tag 'chili_social/application' %>


  • Chili will not be able to automount if you use a catch-all route in your main app (ie match '*a', to: 'errors#routing'), you will have to remove the catch-all or manually add the engine to the main app's routes file.
  • Just like normal engines, Chili requires you to prepend path helpers with main_app (ie main_app.root_path etc) in view templates that are shared with the main app (such as the main app's application layout file).


Current Issues

  • Can only have one override per engine per partial due to the way I'm grabbing the class from the override
  • Haven't found a good way to modify existing controller actions
  • Need to use DSL branch from deface

Minor niggles

  • Have to add gemspec to main app
  • Request specs don't have access to path helpers
Something went wrong with that request. Please try again.