A reactive coding environment built on Pomagma
JavaScript CSS Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
puddle-editor
puddle-server
.gitignore
.jshintrc
.travis.yml
LICENSE
README.md
package.json

README.md

Build Status

Puddle

This is a main Puddle repository.

This repository has documentation on Puddle and overwiew of other puddle modules. While puddle modules are being actievely developed they are checked into this repo as well.

The following puddle- modules are included in this repository:

  • puddle-editor // in memory editor
  • puddle-server // serves files and proxies requests to pomagma backend
  • puddle-cli // simple command line client to puddle-editor
  • puddle-d3 // view only client to puddle-editor

Following modules have ther own repositories:

Please refer to the ./doc for features, architecture, contributing, etc.

Quick Start

Install:

$ npm install

Run:

$ npm start

Then navigate to http://localhost:34934/

Develop mode:

$ npm run develop-editor       # Ctrl-C to stop

In another terminal

$ npm run develop-server       # Ctrl-C to stop

Demo of how to use local modules:

$ git clone git@github.com:pomagma/puddle
$ cd puddle
$ ls
  puddle-corpus
  puddle-hub
  puddle-editor
$ cd puddle-editor
$ mkdir -p node_modules
$ cd node_modules
$ ln -s ../../puddle-corpus  # relative link
$ cd ..
$ git add node_modules/puddle-corpus  # so other devs can use this
$ git commit -m 'Add local npm link to puddle-corpus'

Travis

Travis currently uses a test matrix to test each module individually. To test a single modules, set the environment variable MODULE, for example

MODULE=puddle-corpus npm test  # run tests puddle-corpus only

Make sure to declare environment variables for each of sub modules within .travis.yml.

Contributors

Puddle was factored out of Pomagma in 2014.

License

Copyright 2013-2014 Fritz Obermeyer.
Puddle is licensed under the MIT license.