NOTICE: I'm not actively working on new features for enclave. You should check out the official CLI tool for react: create-react-app. If you are still using enclave and want to make an issue or PR I am happy to respond and make updates :)

A simpler way to compile React applications.

What is this?

An npm module which handles compiling your JSX and ES2015 code into browser-ready JavaScript.

Why do I want this?

If you've ever had to make a React app from scratch, you know it can be rough to set up. Enclave removes the set up so you can focus on what's important, building your app.

Who is this for?

Primarily for those who don't want to go through the hassle of setting up a React project but who still want to flexibility that a starter kit can't provide.

Ok, but what if my app outgrows enclave?

If you find for whatever reason that enclave's management of your webpack and babel dependencies is not offering enough customization for you, merely run:

$ npm run enclave-eject

The

enclave-eject

After executing the eject command,

$ npm run serve

Philosophy

This project comes from a combination of two things, a complexity of configuring React applications with Webpack and Babel (especially for beginners), and my experience with compile-to-JavaScript languages, like Elm or CoffeeScript.

I thought it would be nice to be able to write JSX and ES* the same way I wrote Elm. Just do it, and let some magic happen behind the scenes to make it browser compatible.

Enclave was created with this approach in mind.

What I would like to do is eventually level enclave to the point where it maintains a sane API but is less reliant on Webpack, maybe even have it do the compiling as well.

All in all, this is open experimentation. Hopefully if you're wanting to get started with React you'll find Enclave is a helpful tool to get you up and running quickly.

Getting Started:

Short Version:

$ npm i enclave -S
$ npm run enclave-serve

Long version

$ mkdir my-new-app
$ cd my-new-app
$ npm init
$ npm install enclave --save

Enclave will then take you through a series of prompts. The answers to these prompts will create a

enclave.js

enclave.js

Create an entry point for your application:

$ mkdir src && touch src/App.js src/index.html

import React from 'react'; import { render } from 'react-dom';

class App extends React.Component { render() { return (

render(, document.getElementById('root')); ```

Configure your

index.html

html



  my app


  

Also, this is where you would do things like hook in a cdn or google fonts or whatevs.

Enclave will automagically add a script to your

package.json

$ npm run enclave-serve

If you want to edit your scripts, you can just move the start command somewhere else.

Then find your app at

http://localhost:8080

If you set your port to something other than 8080, then go there instead!.

Currently supported settings

When enclave is installed in your project, it creates an

enclave.js

index.html

After your complete enclave's prompts, you'll find a

enclave.js

/* enclave.js */
exports.entry = "src/App.js"
exports.output = "dist"
exports.port = 3000
exports.index = "src/index.html"
exports.live = true

Contributing

See the Contributing Guide

Learn how Enclave works

License

MIT