tree: 4c4738f83c444eb2d2f10202b0c5b05ae84315cd [path history] [tgz]
  1. bin/
  2. browser/
  3. public/
  4. stylesheets/
  5. test/
  6. .gitignore
  7. .jshintignore
  8. .jshintrc
  9. Makefile
  10. package.json
  11. README.md
client/README.md

release.projects.playground/client

Source code for the Vanadium playground web client.

As of dec-2014, the playground doc is here.

Directory structure

  • bin - Utility scripts for building the client.
  • browser - JS modules to be compiled/bundled via [browserify].
  • Makefile - Targets for building the client (browserifying Javascript, compiling CSS, etc.).
  • node_modules - JS dependencies created by npm install.
  • package.json - Used by npm install to resolve and download dependencies.
  • public - Static assets, including JS/CSS bundles, served by make start.
  • stylesheets - CSS to be compiled to public/bundle.css.
  • test - Client TAP unit tests.

Requires npm and Node.js.

Build the playground web client:

make

The command above automatically fetches Node dependencies and builds necessary assets for the client bundles to the public directory for serving.

Local server

Start a server on http://127.0.0.1:8088

make start

This command will also install any dependencies and build the required bundles.

To run the local dev server with a different configuration you can use variables:

host=`hostname` port=4080 make start

The client running on localhost needs to have the backend address configured via the pgaddr= query parameter.

public/bundle.{js,css}

The default make task will build these for you. The Makefile already has globbing targets for bundling JS and CSS in the browser and stylesheets directories. See these directories for entry points (index files). Such files are bundled into single public/bundle.* files.

The CSS/JS bundles do not rebuild automatically via the server. If you would like the effect of automatic building and seeing your changes on browser refresh you can use the watch utility.

watch make

Deploy

If you do not have access to the vanadium-staging GCE account ping jasoncampbell@. Once you have access you will need to login to the account via the command line.

gcloud auth login

To deploy the playground client to https://staging.playground.v.io use the make target deploy-staging.

make deploy-staging