JSMarka

JSMarka is a Javascript Code Performance benchmarking app

jsmarka.com

Running a local copy of JSMarka

Requirements

1. Node.js v8

2. MongoDB

Install using npm

$ npm install -g jsmarka

$ jsmarka -p 3000

This gets jsmarka server running on port 3000, visit http://localhost:3000/ and start benchmarking. Use jsmarka --help for more useful commands

Setup (Optional)

If you would like to save tests locally, then you should Register a new OAuth GitHub application

Register a new OAuth GitHub application, set the "Callback" url to http://localhost:3000/auth, then get the apps' "Client ID" and "Client Secret".

Note: You should set the GitHub App "Callback" urls' port to whatever you've configured jsmarka to run on. (see below)

Set up jsmarka via CLI

Run:

$ jsmarka --setup

After the setup, a .env file containing your setup info is created, to view the contents of this file do:

$ jsmarka --list

You can see that the PORT value is the same port used in the GitHub App Callback URL, that's how yours should be set.

Run jsmarka --help to see useful commands.

Development

If you're installing JSMarka for development purpopses then you have to clone this repo and install its dependencies:

$ git clone http://github.com/kodejuice/jsmarka.git
$ cd jsmarka
$ npm install

Contributing to JSMarka

Submit a pull request to master with passing tests (npm test).

Run:

$ npm run dev

before writting code, as it automatically:

1. Restarts the server on every change
2. Re-builds the assets (if you make any changes inside client/)

Use npm run build to manually re-build the assets

Testing

JSMarka uses CasperJS which in turn requires PhantomJS for end-to-end testing, So you should have both casperjs and phantomjs installed on your system.

First, have a separate terminal running npm start

Then run the test suites in another terminal/tab:

$ npm test

Screenshots are taken, find them in the test/screenshots/ folder.