/brjs

BladeRunnerJS (BRJS) is an open source development toolkit and framework for modular construction of large single-page HTML5 apps. It consists of a set of conventions, supporting tools and micro-libraries that make it easy to develop, test, deploy and maintain complex JavaScript apps.

Primary LanguageJavaScriptGNU Lesser General Public License v3.0LGPL-3.0

BladeRunnerJS (BRJS)

Divide & conquer complex web apps

Build Status

Getting Started

The best way to get started depends on why you're here.

Documentation

The main documentation for BRJS can be found via http://bladerunnerjs.org/docs. The source code for the documentation can be found via https://github.com/BladeRunnerJS/brjs-site so if you find any error or have any suggestions please submit a pull request.

API reference guides are coming soon.

BRJS Core Toolkit Development

If you are interested in contributing to the BRJS core toolkit then the following information is of use.

How to build BRJS

Get the code

git clone git@github.com:BladeRunnerJS/brjs.git
cd brjs

Install JDK

BRJS is written and compiled using Java 8, but we distribute it and run the tests against it using Java 7, courtesy of retrolambda. Because of this, you will need to do the following:

  • Install both Java 7 and Java 8 JDKs.
  • Configure JAVA7_HOME to point to the Java 7 JDK home directory.
  • Configure JAVA8_HOME to point to the Java 8 JDK home directory.
  • Configure JAVA_HOME to point to either the Java 7 or the Java 8 JDK home directory, as you prefer.
  • Configure the path environment variable to include $JAVA_HOME/bin.

If you install Java using the Windows installer than it places a 'java' executable in 'C:\windows\system32' that proxies to the most recently installed version of Java. You will either need to install your preferred implementation of Java last, or ensure that the path to the Java 'bin' directory appears before 'C:\windows\system32'.

Build a Distributable Zip

From the root brjs source directory:

$ ./gradlew brjs-sdk:distZip

The built zip file will be found in BRJS_ROOT/brjs-sdk/build/distributions/ in the format BladeRunner-VERSION.zip.

More information

See the BRJS Developer Setup Guide for more information. See how the BRJS team use Github and git.