README.md

ReactJS.NET

ReactJS.NET is a library that makes it easier to use Facebook's React and JSX from C#.

     

Features

• On-the-fly JSX to JavaScript compilation
• JSX to JavaScript compilation via popular minification/combination libraries:
  • ASP.NET Bundling and Minification
  • Cassette
  • Webpack
• Server-side component rendering to make your initial render super-fast (experimental!)
• Runs on Linux via Mono and V8

Quick Start

Install the package

Install-Package React.Web.Mvc4

Create JSX files

// /Scripts/HelloWorld.jsx
var HelloWorld = React.createClass({
    render: function () {
        return (
            <div>Hello {this.props.name}</div>
        );
    }
});

Reference the JSX files from your HTML

<script src="@Url.Content("~/Scripts/HelloWorld.jsx")"></script>

Now you can use the HelloWorld component.

For information on more advanced topics (including precompilation and server-side rendering), check out the documentation

Building Manually and Contributing

When building your own copy of ReactJS.NET (for example, if implementing a new feature or fixing a bug), your first build always needs to be done using the build script (dev-build.bat) as this generates a few files required by the build (such as SharedAssemblyVersionInfo.cs). Once this build is completed, you can open React.sln in Visual Studio and compile directly from Visual Studio. Please refer to the documentation page on contributing for more information on contributing to ReactJS.NET.

Note that the build requires you to have Git installed. If you do not want to install Git, you may remove the GitVersion task from build.proj.