Parallax microcontroller development environment based on Chrome applications.
Clone or download
Latest commit b782cf7 Oct 26, 2017
Permalink
Failed to load latest commit information.
_locales/en reduce character count in description Sep 16, 2015
assets updated changes from PR Apr 8, 2016
examples Restructure examples, convert to plugin Oct 30, 2015
fonts add fancy buttons and overlay plugin Mar 19, 2015
icons add icons to the application - closes #53 Apr 5, 2015
readme-images created new images with consistent references and better highlighting. Jun 19, 2015
src add delay for windows serial disconnect Oct 20, 2017
test remove all ChromeIDE references Jun 19, 2015
.editorconfig initial manifest - closes #1 Feb 23, 2015
.eslintrc update eslint rules Aug 25, 2015
.gitattributes initial manifest - closes #1 Feb 23, 2015
.gitignore add dedupe plugin and source maps for development Apr 10, 2015
.travis.yml update travis Oct 20, 2017
LICENSE Initial commit Feb 17, 2015
README.md Added cache clean instruction for updating all Oct 14, 2017
background.js cleanup Sep 14, 2015
client.js handle overwrite cancel and remove overlay plugin Oct 30, 2015
dependency-licenses.md add generated dependency tree license listing Apr 10, 2015
gulpfile.babel.js simplify versioning process with a lifecycle script Sep 18, 2015
index.html remove '.do-not-print' style and targeted the component directly usin… Jul 15, 2015
manifest.json Bumped version to v0.14.0 Oct 25, 2017
package.json Bumped version to v0.14.0 Oct 25, 2017
webpack.config.js Add example directory and webpack config Oct 29, 2015
zuul.config.js new zuul config Aug 6, 2015

README.md

Parallax IDE

Write, compile, and download code to your Parallax Boe-Bot Robot or custom BASIC Stamp microcontroller-based electronic creations.

Quickstart

  1. Visit our github releases and download the desired release or download the latest release here.

  2. Go to your downloads folder and unzip the archive.

Note: for use on Chromebook you will need to unzip the archive and copy the unzipped directory onto the Chromebook.

  1. Open Chrome and follow the Installing in Chrome instructions.

Building from Source/Developing

Most of below is a one-time procedure needed to build the application, unless otherwise noted. To build the application you will need the node.js JavaScript runtime. node.js itself comes bundled with the npm package manager. If you don't have it, then:

  1. Install node.js by going to nodejs.org/download and selecting the option that is right for your system.

  2. You also need all the dependencies for node-gyp, a tool that comes with node.js for compiling native addon modules. The gyp project is used by the Chromium team makes it easier to build across platforms.

Please visit the node-gyp page and note your system and the dependencies you will need.

* Note: that you do not need to install node-gyp, only its dependencies.

  1. Clone this respository. Assuming you have git installed (if not, go here), choose your file destination from the command-line (CLI like Terminal), and

git clone git@github.com:parallaxinc/Parallax-IDE

clone repo

  1. Go to the project root directory with

cd Parallax-IDE/

  1. Get all the project dependencies. At the root of the project you will find package.json. This manifest file includes a list of project dependencies needed to build the application. To learn more, see this post on dependency installation. This step must be run each time you update the repository (including pulling updates from GitHub).

To get dependencies, enter:

npm install

Note: To ensure all dependencies are updated, it's recommended to do the following

npm cache clean
npm install
  1. Build the application by entering. This step must be run each time you update the repository (including pulling updates from GitHub).

npm run build or npm run build -- --watch*

* Note: using --watch will result in a rebuild of the application any time a file changes

Installing in Chrome

  1. Open your Chrome browser and navigate to

chrome://extensions

  1. Enable 'Developer Mode' by clicking the checkbox.

enable developer mode

  1. Before you install your extension must be built and bundled. If you haven't done so follow the instructions in the Build from Source section first.

  2. Click on 'Load unpacked extensions...', go to the directory where Parallax IDE was built, highlight the 'Parallax-IDE' folder and and click select.

    load extension select folder

  3. Return to the chrome://extensions page and you should see 'Parallax IDE' listed in available extensions.

    Parallax IDE listed

  4. Ensure the checkbox is 'enabled' and click 'launch'.

  5. Congratulations! You just launched Parallax IDE which will look something like this:

    app launched

Coming Back

One you install the built application it is super easy to launch it again. You can either:

  • go to chrome:// extensions, search through the list until you find Parallax IDE and then click `launch'

or

  • go to chrome app launcher and click on/search for Parallax IDE

    chrome app launcher

    click Parallax IDE