Skip to content

spatten/waterbear

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Waterbear

Description

Waterbear is a toolkit for making programming more accessible and fun. Not a language itself, but a block syntax inspired by Scratch (http://scratch.mit.edu/) that can be used to represent langauges. Waterbear's blocks drag and snap together, representing code that eliminates syntax errors much like garbage collection alleviates memory errors and bound checking helps prevent overrun errors.

Waterbear's system of draggable, snappable blocks, are built using clean HTML5, CSS3, and Javascript. The goal is not to slavishly duplicate Scratch, or to create a programming language, but to create a visual syntax tool that can be used with a variety of languages and projects.

The motivation is to reduce syntax errors in the same way that garbage collection has reduced memory errors, or bounds checking has reduced overrun errors. I have also been testing various programming systems on my own kids, and Scratch is the one tool they were able to pick up easily, both for creating projects and for reading/modifying other people's projects. Waterbear is a way of relaxing some of the restrictions imposed on Scratch, and opening it up to the web at large.

The look and feel of Waterbear differs from Scratch, which is implemented in Squeak Smalltalk's Morphic environment. Waterbear blocks are intended to use web technologies naturally, without trying to force them into a different paradigm. In other words, this project is attempting to create blocks in a web-centric way. Waterbear is designed to be easy to use on both desktop/laptop browsers and on iPads and smart phones.

Waterbear is pre-alpha software, very raw, and in constant flux right now.

Installation

Waterbear is pure Javascript. The only external dependencies are on jQuery (currently 1.5.1) and Modernizr (1.6). Some Waterbear block sets may have further dependencies, on Processing.js, Raphael.js, or Crafty.js (for instance).

Update: Have removed Modernizr dependency, but added dependencies on bPopup (http://dinbror.dk/blog/bPopup/) and Colorwheel (http://jweir.github.com/colorwheel/). Have also regressed Raphael to an earlier version to avoid bugs in the current version.

Demo

There is a demo of a recent build (not guaranteed to be working at any given time) of waterbear here: waterbear.livingcode.org, if you would like a (very early) sneak preview.

Where to get help

The best way to get help right now is to email me: [dethe ATGLYPH livingcode DOTGLYPH org]. As the project progresses I will set up a mailing list or forum, buglist, etc. The documentation for Waterbear will live here: Waterbear Documentation. You can follow this project on twitter at @water_bear.

Acknowledgements

  • My kids, Azlen and Mina, for helping test so many programming environments and being my best critics
  • Steve Dekorte, Alex Payne, Bob Nystrom, Wolf Rentzsch, Victoria Wang, and Brian Leroux for the encouragement to make this real
  • Scratch, the primary source of inspiration for this project
  • Alice
  • StarLogo
  • Basic
  • Quartz Composer
  • NodeBox
  • Processing
  • Processing.js
  • Raphael
  • Crafty

Contributors

  • Dethe Elza
  • [Your name here]

License

Copyright 2011 Dethe Elza

Waterbear code licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Creative Commons License
Waterbear Documentation by Dethe Elza is licensed under a Creative Commons Attribution 3.0 Unported License.
Permissions beyond the scope of this license may be available at http://www.apache.org/licenses/LICENSE-2.0.

Coming Features

  • Autogenerate variable names
  • Full web site with tutorial and forums
  • Option blocks - generalize block creation with selection lists
  • Zoom into script view
  • Build new blocks in Workspace
  • Show all blocks (workaround for block drift bug)
  • Larger script workspace, with scrollbars
  • Multiple script workspaces (allows one per sprite, for instance)
  • [optional] Allow contained blocks to overflow right edge of block without growing block
  • Contribution guidelines
  • Contributor list
  • Credits, inspirations, alternatives
  • Built-in demos
  • Test, specs, features, examples
  • Reach out: Facebook, IRC
  • Get design help, especially for workspace
  • Waterbear logo
  • Better code formatting for code view
  • Script embedding
  • Server for saving and sharing scripts

Bugs

  • Make sure restore dialogue scrolls
  • Block labels wrapping on Firefox
  • Clicking into tabs doesn't work on iPad
  • Dragging block out of a Boolean socket doesn't restore select element
  • Clicking into an input doesn't select contents
  • Clicking into an input after the first input puts cursor in first input
  • Visual cues when snapping are overly subtle
  • Snap regions too small
  • On drop, remove "active_drop" class

About

Visual block syntax for programming languages

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published