Wiki

Clone wiki

MintOil-Open / Home

Welcome

This is a brief overview on how to utilize build and use the source code in this repo.

Before we begin, feel free to use this software via the Chrome Web Store.

ChromeWebStore_BadgeWBorder_v2_206x58[1].png

The Source Code

Firstly you will need to clone this repo's develop branch as master is reserved for production releases.

$ git clone git@bitbucket.org:caelusminds/mintoil-open.git && git fetch && git checkout develop

Development Environment

This was developed in JetBrain's WebStorm on a Windows machine, so there will be a few artifacts in the source that make some things easier in that IDE.

NOTE: If you are to develop with this specific code-base, you'll need to know that both mint.com (mint.intuit.com) and the extension background page will need to have a local-storage key/value pair injected.

env | debug
If you are familiar with DevTools you'll know how to do this, otherwise I would advise familiarizing yourself and coming back.

Chrome Extension Standards (...sorta)

Since this is a Chrome extension in follows all of the documentation found on developer.chrome.com.

However, this is small exception in this build... we have a manifest.js file off of the root that is a node-script that runs a routine to "build" the manifest.json.

To run this:

$ node manifest.js
It's also part of the npm scripts.

Building

We've written a brief node-script to minify/uglify and pack everything relevant into an archive.

$ node .scripts/pack.js
This archive is only really relevant for the upload of the Extension to the Web Store, or unzip and test the directory without the aforementioned env|debug localStorage injection.

Updated