The Blockstack Browser allows you to explore the Blockstack internet.

1. Clone this repo from https://github.com/blockstack/blockstack-browser.git
2. Run npm install from the root directory
3. Run npm run dev to run locally

Note: When you do npm run dev you're running two concurrent processes. One starts a CORS proxy on port 1337. The other runs a BrowserSync process that watches the assets in /app, then builds them and places them in /build, and in turn serves them up on port 3000. Anytime changes are made to the original files, they are rebuilt and resynced to the browser frames you have open.

1. Make sure you've cloned the repo and installed all npm assets (as shown above)
2. Run npm run web

1. Make sure you have a working installation of Xcode 8 or higher & valid Mac Developer signing certificate
2. Run npm install nexe -g to install the "node to native" binary tool globally
3. Open the Blockstack macOS project in Xcode and configure your code signing development team (You only need to do this once)
4. Run npm run mac to build a release signed with your Mac Developer certificate

Note: You only need to run nexe once but the first build will take a while as nexe downloads and compiles a source copy of node. Then it creates and copies the needed proxy binaries into place and copies a built version of the browser web app into the source tree.

Note: This has only been tested on macOS Sierra 10.12.

1. Ensure you have valid Developer ID signing credentials in your Keychain. (See https://developer.apple.com/developer-id/ for more information)
2. Follow the instructions in the above section for building for macOS.
3. Open the Blockstack macOS project in Xcode.
4. Select the Product menu and click Archive.
5. When the archive build completes, the Organizer window will open. Select your new build.
6. Click "Export..."
7. Click "Export a Developer ID-signed Application"
8. Choose the development team with the Developer ID you'd like to use to sign the application.
9. Click "Export" and select the location to which you would like to save the signed build.

This app uses the latest versions of the following libraries:

• React Rocket Boilerplate
• ReactJS
• React Router
• RefluxJS
• Gulp
• Browserify
• Redux
• Babel

Along with many Gulp libraries (these can be seen in either package.json, or at the top of each task in /gulp/tasks/).

1. If you haven't already, follow steps 1 & 2 above
2. If you haven't already run npm run dev or npm run build at least once, run npm run build
3. Run all tests in the tests/ directory with the npm run test command

• A single file can be run by specifing an -f flag: npm run test -f <PATH_TO_TEST_FILE>
  • In the PATH_TO_TEST_FILE, it is possible to omit the tests/ prefix, as well as the .test.js suffix. They will be automatically added if not detected.

Note: When running tests, code coverage will be automatically calculated and output to an HTML file using the Istanbul library. These files can be seen in the generated coverage/ directory.