Google Git
Sign in
vanadium / release.projects.browser / 570155e5af9eb78150709338627cbb0e2aa3b4d9
commit570155e5af9eb78150709338627cbb0e2aa3b4d9[log] [tgz]
authorWm Leler <wmleler@google.com>Thu Apr 30 14:10:09 2015 -0700
committerWm Leler <wmleler@google.com>Thu Apr 30 14:10:14 2015 -0700
treef9d8e41355342514ec45f7e6dbf09b2d1ceaa0d0
parent15e35de4e6a22af6270cc9b5abacaae3484a91f9 [diff]
Fix radial icons

Closes #75

Change-Id: I40a436a36d341b98242380420e5b8f7368476abb
1 file changed
tree: f9d8e41355342514ec45f7e6dbf09b2d1ceaa0d0
  1. go/
  2. public/
  3. src/
  4. test/
  5. .gitignore
  6. .jshintrc
  7. AUTHORS
  8. bower.json
  9. CONTRIBUTORS
  10. css-transform.js
  11. LICENSE
  12. main-transform.js
  13. Makefile
  14. md-transform.js
  15. package.json
  16. PATENTS
  17. README.md
  18. VERSION
  19. web-component-dependencies.html
README.md

Vanadium Namespace Browser

The namespace browser is a web application that lets developers and other users view and interact with the Vanadium world. Starting from their namespace root or other mount table, users can browse through the mount table hierarchy and see where services are mounted. The user can select a service to see more detailed information about it, and can also interact with the service, invoking methods to examine or modify the state of the service.

Installing the Vanadium Extension

As a Vanadium web application, the Namespace Browser requires that users install the Vanadium Extension from the Chrome Web Store. If you try to run the web app without the extension, it will prompt you to install it.

Here is the link to the Vanadium Extension: https://chrome.google.com/webstore/detail/vanadium-extension/jcaelnibllfoobpedofhlaobfcoknpap

Hosted Namespace Browser

The Vanadium Namespace Browser lives online at https://browser.v.io/

Building the Namespace Browser

You do not need to build your own copy of the namespace browser in order to use it, unless you want to modify it or see how it works.

To build a local copy, install the Vanadium environment and be sure to include the web profile.

Here is the link to the development instructions for Vanadium: https://v.io/community/contributing.html

Next, to build your own copy of the namespace browser, run:

cd $V23_ROOT/release/projects/browser
make build

This compiles the relevant bundle files in the ‘public’ folder. The assets inside must be served as your own instance of the web app.

Running locally for development

You can serve a local instance of the Namespace Browser by executing the following command:

make start

This will also generate Vanadium credentials (a new principal and a blessing) the first time it is run, which may prompt you for your Google Account password and caveats on the blessing in your web browser. You will also be prompted to select a password for encrypting the credentials on local disk. This is optional.

Navigate to http://localhost:9001 to launch the namespace browser. You can quit by using CTRL-C on the console running make start.

If you have any problems after updating the code, try cleaning the build.

make clean
make start

Additionally, demo services and mount tables that represent a virtual house and cottage are added to your local namespace, under users. For more information, see the help pages in the Namespace Browser application (click on the menu icon in the upper-left corner, then select Help).

Testing

The namespace browser has some unit and integration tests that verify basic functionality. Run these tests with the following command:

make test

Contributing

The code repository for the Namespace Browser is on GitHub.

Bugs and other issues can be submitted to the Namespace Browser Issue Tracker.