tdaubs / tw-kanban-js

A kanban board in a single html file from http://scm.zoomquiet.io/data/20110709023400/index.html

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Taskwarrior-Kanban

(forked from Simple-Kanban)

Simple Kanban is/was a single-html-file kanban board, written by Stephan Schmidt in 2009, and formerly hosted at http://scm.zoomquiet.io/data/20110709023400/index.html and (now empty repository) https://github.com/StephanSchmidt/SimpleKanban. There was only ever one release, and now the github repo has been cleared out, empty, and all the links are 404.

Luckily, I had a copy of one of the magic html files, and it was released inder the MIT license, and so I'm taking the liberty of preserving it, and hoping to develop it into a taskwarrior-specific thing.

To understand why this might be interesting at all, you MUST download the kanban.html file above (better yet, clone the repo) and open it in a browser. Then this will ALL make more sense. It's brilliant! Try it right now!!

The end-goal is to develop a simple and effective kanban board for taskwarrior.org . Using a UDA "state:" that defines what state (if any) a task is in, tasks could then be visually Drag and Dropped from one state to another (from one "swimlane" or "story" to another) and using javascript interacting with task, and changing the state:value accordingly.


Original Docs

<title>Simple-Kanban | The one file kanban board application</title>
Simple Kanban Logo

A Kanban Board Application in Simply One Html File

What is Simple-Kanban?

Simple-Kanban is a Kanban board application and can be used in lean software development. While introducing lean practices, I've needed a small, simple Kanban Board application. Decided I'd write one.

Simple Kanban Screenshot 1

You can download a first 1.0 RC version here or see it in action here. Simple-Kanban is Open Source software, free for personal and commercial use and licensed under a MIT license.

Suprised? The application is just one HTML file, no installation needed, no Java, Ruby or PHP. One HTML file, no other dependencies.

Why should I use Simple-Kanban?

If you're working in stories, use Kanban, Scrum, or another agile approach, you should use a Story/Kanban board. Simple-Kanban is an application to manage such a Kanban board. A Kanban board informs a company about the stories which are in development and in which state they are. Everyone knows what's happening, because such a board is an ideal information radiator. This leads to more transparency and less status meetings or questions to your developers about project status. With a Kanban board you can see bottlenecks, adress them and optimize flow through your organisation.

Best to use Simple-Kanban on a huge screen, if you do so, please send me a picture if possible.

How to use Simple-Kanban?

You can drag stories around and drop them in every column. If you want to edit the stories, add stories or remove stories, click on the "Data" link in the top right corner. You will find a list of stories. The example contains those:

T_Q,S18,Checkout optimize
DE,S2,Build old shop
DE,S4,Rebuild with SOAP
DE_Q,S10,Rebuild with REST
P,S17,Do something with OpenID
D,S3,Make application faster
D_Q,S7,Credit Card Payment
DE,S13,Build something astonishing
P_Q,S17,Fix YSlow
R,S39,Google Page Speed fix

There are three columns for stories. The first column contains the state the story is in, the second contains an identifier for your story and the last column the name of the story. You can edit the columns, change states, change names, remove and add stories. You can also export form Excel to csv, then cut& into the application source.

After your satisfied with your changes and want to go back to the Simple-Kanban board view, click on the top right corner on "Board". Simple-Kanban will then change back to the board view.

How do I save the stories?

Go to the data view and copy all stories. Then simply edit the source of the HTML file with an editor of your choice, preferably one which knows HTML. There you can paste the copied stories over the old ones and save the HTML file.

How do I change the possible states?

When looking into the source file, the available states are described next in the block after the stories:

D,Design
DE,Development
T,Test
R,Release

You can edit them in the source file just as you like. If you save the HTML file, the states are save too. The states need to be available for the stories and match the states of the stories. You can add, remove or change states. Every state has a "sub-state" as a ready queue. For example the ready queue state for Design "D" is "D_Q", for Test"T" it is "T_Q". You do not need to describe the ready states, they are automatically created and a ready queue is shown in front of every state. For example "Test Ready" is shown left to "Test".

Customize the colors

The colors of each state are defined in a CSS block.

 #D .box { background-color: #FFC300; color: #000000;}
#D_Q .box { background-color: #F0F0F0; color: #606060;}

Feel free to change them to your taste. "#D .box" is for the boxes in the "D" column, "D_Q .box" is for the for the corresponding ready queue.

Future

I'm thinking about a CouchDB storage implementation for storing data and application logic. Or storing data in the file like TiddlyWiki does. Future lean features? Add WIP limits, add "From here" signs to display cycle time until live. Have fun with this One-File-HTML-application. Tip: you can easily mail it around, to developers, product manager, your boss or top managment. No install needed.

There are several packages for download. To download Simple-Kanban, save the HTML page or save the link with "Save link as..." Simple-Kanban is Open Source software, free for personal and commercial use and licensed under a MIT license.

Simple Kanban 1.0RC1 example file
Simple Kanban 1.0RC1 empty file to start
Simple Kanban 1.0RC1 ZIP file with all files

Source Code

The source code is hosted on Gitbub
http://github.com/StephanSchmidt/SimpleKanban/tree/master
Download Simple-Kanban

You can download a very first 1.0 RC version here. Simple-Kanban is Open Source, free for personal and commercial use and licensed under a MIT license.

Source code

The source code can be found on Github

If you like Simple-Kanban, and would like to learn more about lean, Kanban and software development, follow me on by blog at codemonkeyism.com or twitter about Simple-Kanban:

About

A kanban board in a single html file from http://scm.zoomquiet.io/data/20110709023400/index.html