memo/README.markdown

82 lines
3.2 KiB
Markdown
Raw Normal View History

2011-03-09 23:56:52 -05:00
scrumblr
========
what is it
----------
[scrumblr](http://scrumblr.ca) is a web-based simulation of a physical agile sprint board that supports real-time collaboration. it is built using node.js, websockets (using socket.io), CSS3, and jquery. i hope you like it.
2011-03-09 23:56:52 -05:00
2011-03-10 07:57:57 -05:00
![Wellca Board](http://scrumblr.ca/images/screenshot.png)
2011-03-09 23:56:52 -05:00
2011-03-10 07:57:57 -05:00
you can play with a demo here:
2011-03-10 08:15:53 -05:00
- [scrumblr.ca/demo](http://scrumblr.ca/demo)
2011-03-10 07:57:57 -05:00
And view a video here:
2011-03-10 08:15:53 -05:00
- [Video Demo](http://www.youtube.com/watch?v=gAKxyOh1zPk)
2011-03-10 07:57:57 -05:00
use scrumblr
------------
if you'd like to use scrumblr go to [scrumblr.ca](http://scrumblr.ca). new boards are made simply by modifying the url to something unique. e.g. your team could use a shared board at: *http://scrumblr.ca/thisisoursecretboard23423242*
2011-03-10 07:57:57 -05:00
2011-03-10 08:31:17 -05:00
alternatively, you can follow the instructions below to setup scrumblr yourself. it is very simple -- it just uses redis and node.js.
2011-03-10 07:57:57 -05:00
2011-03-10 08:14:15 -05:00
if you are a developer, please fork and submit changes/fixes.
2011-03-10 07:57:57 -05:00
browser support
---------------
scrumblr works on up to date chrome and firefox browsers. enable websockets for optimal performance. tested mainly on chrome for osx. this was not designed for browser support. use chrome for this app.
2011-03-09 23:56:52 -05:00
design philosophy
-----------------
2011-03-10 08:33:23 -05:00
my goal was to avoid buttons and ui (almost everything is edit in place or draggable). everything should be discoverable (no "help"). the look is meant to be as close as possible to [Well.ca's](http://well.ca) real sprint board. see picture below. many of the decisions were to make the app look and feel as much as possible like well.ca's real sprint board -- you may find this annoying but we find it kinda funny.
2011-03-09 23:56:52 -05:00
2011-03-10 00:02:10 -05:00
![Wellca Board](http://scrumblr.ca/images/DSC_7093.jpg)
2011-03-09 23:56:52 -05:00
how to install and run on your own computer (linux/osx)
-------------------------------------------------------
2011-03-10 07:57:57 -05:00
- install redis v2.2.2
- install node.js >= 0.4.1
2011-03-09 23:56:52 -05:00
- install npm
- install these npm packages:
- async
- express
- jade
- redis-client
- redis
- sanitizer
- socket.io
2011-03-10 13:54:55 -05:00
- simplesets
- connect-redis
2011-03-10 07:57:57 -05:00
- (and perhaps more which you will notice when you try to start it)
2011-03-10 08:14:15 -05:00
- now start redis ($ redis-server)
- now start ($ node server.js 80) where "80" is the port you want it to run on.
2011-03-11 13:07:20 -05:00
license
2011-03-10 08:14:15 -05:00
-------
2011-03-11 13:07:20 -05:00
scrumblr is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
scrumblr is distributed in the hope that it will be useful,
2011-03-11 13:07:20 -05:00
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See <http://www.gnu.org/licenses/>.
the *images* used in scrumblr, however are licensed under cc non commercial noderivs:
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by-nc-nd/3.0/80x15.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License</a>.
2011-03-10 08:14:15 -05:00
author
------
ali asaria - [well.ca](http://well.ca) - ali [at] well.ca