No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Preprocessor for Coffeescript with React JSX (CJSX). This gem makes it easy to integrate this into the Rails asset pipeline or other Sprockets chains. If you want to use CJSX without Sprockets, see the coffee-react gem, or the coffee-react npm module.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

sprockets-coffee-react¶ ↑

STATUS: DEPRECATED¶ ↑

This tool is no longer maintained. If you need to transition your codebase from it, a codemod is available to do so: cjsx-codemod

This project started as a way for me to explore how JSX could fit into Coffeescript syntax, as a quickly hacked together prototype. While I never really promoted it, it quickly took on a life of its own, and before long people were asking for it to support all kinds of different use cases. On top of that I had no experience writing parsers, so the result is something with insurmountable limitations.

As I eventually stopped using Coffeescript I ended up neglecting this project, but as people were using it I didn’t want to kill it. I really should have, however, because it meant that people were using a crappy, ill-conceived, unmaintained tool. Now, long overdue, I’m putting it out to pasture.

Original readme follows:

Compatibility¶ ↑

sprockets-coffee-react 2.x is compatible with react ^0.12.0

sprockets-coffee-react 0.x is compatible with react <=0.11.0

How to use¶ ↑

Add this to your Gemfile:

gem 'sprockets-coffee-react'

Place a .js.coffee.cjsx or .js.cjsx file, or a .js.coffee file in your assets directory. When you require it into other JS files the CJSX markup will be transformed and compiled to Javascript.

Eg. if you have a file called my-component.js.coffee which contains some CJSX code, require it from application.js or somewhere else:

//= require my-component

How to use with a Rack application¶ ↑

If you’re not using rails, you’ll need to register the Sprockets preprocessor manually. Here is an adapted version of the Rack example provided by Sprockets, which additionally requires and registers the sprockets-coffee-react engine:

require 'sprockets'
require 'sprockets/coffee-react'
map '/assets' do
  environment = Sprockets::Environment.new
  environment.append_path 'app/assets/javascripts'
  environment.append_path 'app/assets/stylesheets'
  environment.register_preprocessor 'application/javascript', Sprockets::CoffeeReact
  environment.register_engine '.cjsx', Sprockets::CoffeeReactScript
  environment.register_engine '.js.cjsx', Sprockets::CoffeeReactScript
  run environment
end

map '/' do
  run YourRackApp
end

License¶ ↑

Released under the MIT License. See the LICENSE file for further details.

How to use with Middleman¶ ↑

Add the following to your config.rb file:

require 'sprockets/coffee-react'

::Sprockets.register_preprocessor 'application/javascript', ::Sprockets::CoffeeReact
::Sprockets.register_engine '.cjsx', ::Sprockets::CoffeeReactScript
::Sprockets.register_engine '.js.cjsx', ::Sprockets::CoffeeReactScript