You can work on the UI without needing a VM, by using web-server.js. There are a few limitations, such as login not being available, but it works well enough for quick testing. For instructions on how to serve the UI with working URL rewriting, see the Vagrant instructions.
Running the web-server¶
By default, the web server will serve data from treeherder production. If you wish to test the UI against treeherder stage instead, type:
If you wish to test the UI against a custom service, type:
./web-server.js --server <url>
Please note that if
ui/js/config/local.conf.js exists, the above configuration will be overwritten by
thServiceDomain in the config file.
If you wish to run the full treeherder Vagrant project (service + UI), remember to remove local.conf.js or else change
thServiceDomain within it to refer to
vagrant, so the UI will use the local Vagrant service API.
- If you haven’t already done so, install local dependencies by running
yarn install --no-bin-linksfrom the project root.
yarn run lint.