This was a one-night weekend project to:
-
Learn more about http calls to a 3rd party API using Meteor
-
Visualize all my Someday cards tucked away in a Sprintly project I'm working on (my startup, Kyn). Love me some Sprintly, but don't love how they don't take advantage of the full screen width on certain views, particularly the triage view in the Organizer.
This project wouldn't have been possible without the following reference apps/gists:
-
This gist from nachiket-p demonstrating a basic API call via Meteor.
-
Meteor-synched-drag from drgorb for the freeform canvas functionality.
You guys are awesome…thanks!
- Add a way to visually connect certain stories (e.g. jsPlumb)
- The db isn't hooked up, so as soon as you do a browser refresh your work is destroyed.
- The API call is one-way (GET). Would be great to reorder/prioritize and send back to Sprintly. An alternative is to add tags in lieu of ordering and/or move certain stories to backlog.
Note: I'm a beginner, and these instructions are intended to help other beginners get up and rolling quickly.
You need to have Node.js and Meteor installed.
I use Homebrew and found this tutorial helpful.
Install Meteor:
curl https://install.meteor.com | sh
Install Meteorite:
npm install -g meteorite
Add jQuery UI package:
mrt add jquery-ui
cd into the app
cd what/ever/your/path/is/sprintly-visualizer
Start Meteor
meteor
Open the app in your browser
http://localhost:3000/
-
Insert your Sprintly credentials
These are located insettings.json.example
. Be sure to save the new file assettings.json
(e.g. remove the "example" extension).
Note: Here's how to find your API Key. -
Load your settings.json file
meteor --settings settings.json
Notes: (a) Be sure meteor is not already running. (b) If you're going to deploy this to meteor's free hosting (i.e. yourappname.meteor.com), don't forget to load your settings.json file upon deploy as well:meteor deploy yourappname --password --settings settings.json
And please, make sure you password-protect your site if deploying to meteors servers (that's the --password
command while hitting meteor deploy
). Otherwise, your Sprintly API key credentials could be exposed.
##Misc Notes
- Error handling from Sprintly responses are NOT hooked up yet, so open up console if your app is throwing errors.
- Half of the app is for the drag and drop functionality. If you just want to see how the API call is set up without all the additional clutter, revert back to this commit.
This code is provided "as is" with no warranties. It'll probably break and may expose your api keys and all of your inner-most secrets. Proceed with caution.
Sprintly card design copyright (c) Sprint.ly. All else, do with it as you wish, commercial or otherwise.