Gitiles
Code Review Sign In
gerrit.onosproject.org / onos / 0e161094093a89ecb072b4cdd80005c52c2aeb72 / . / web / gui / src / main / webapp
tree: 848d48558a9091274850d045089fa44c920960e5 [path history] [tgz]
  1. README.md
  2. WEB-INF/
  3. _dev/
  4. _doc/
  5. app/
  6. bs-config.js
  7. data/
  8. dev_server.js
  9. error.html
  10. index.html
  11. login.html
  12. nav.html
  13. not-ready.html
  14. onos.js
  15. package.json
  16. raw/
  17. tests/
  18. tp/
web/gui/src/main/webapp/README.md

ONOS UI

Development environment

To help with UI development we provide a dedicated environment that introduce an auto reload feature and allow you to change your javascript files without recompiling the application.

To get started:

  • Be sure to have Node Js installed
  • Enter web/gui/src/main/webapp/ folder
  • Run npm install to install required dependency
  • Run npm start to open start the development environment

In the console you should see something like:

Dev server is up and listening on http://localhost: 8182
[BS] Proxying: http://localhost:8181
[BS] Access URLs:
 ----------------------------------
       Local: http://localhost:3000
    External: http://10.1.8.46:3000
 ----------------------------------
          UI: http://localhost:3002
 UI External: http://10.1.8.46:3002
 ----------------------------------
[BS] Watching files...

To open ONOS visit the local URL (eg: http://localhost:3000) plus /onos/ui (eg: http://localhost:3000/onos/ui)

Loading files from external applications

The UI development environment provide the ability to serve UI files from an external forlder that can be specified with: ONOS_EXTERNAL_APP_DIRS="appName:path-to-the-first-folder" npm start

Eg: ONOS_EXTERNAL_APP_DIRS="sampleCustom:../../meow/sample/meowster-sample/" npm start

Note that ONOS_EXTERNAL_APP_DIRS is an environment variable,so it can be set with export ONOS_EXTERNAL_APP_DIRS="sampleCustom:../../meow/sample/meowster-sample/"