You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -21,12 +21,14 @@ Open-RMF Web is a collection of packages that provide a web-based interface for
21
21
We currently support [Ubuntu 24.04](https://releases.ubuntu.com/noble/), [ROS 2 Jazzy](https://docs.ros.org/en/jazzy/index.html) and Open-RMF's [22.09](https://github.com/open-rmf/rmf/releases/tag/22.09) release. Other distributions may work as well, but is not guaranteed.
> Simulation demos are not part of the released binaries, and therefore a built workspace with at least the [demos repository](https://github.com/open-rmf/rmf_demos) would be required for trying out the web dashboard with simulation.
42
44
43
45
### Install dependencies
44
46
45
47
Run
48
+
46
49
```bash
47
50
pnpm install
48
51
```
49
52
50
53
You may also install dependencies for only a subset of the packages
54
+
51
55
```bash
52
56
pnpm install -w --filter <package>...
53
57
```
54
58
55
59
### Launching
56
60
57
61
Source Open-RMF and launch the dashboard in development mode,
62
+
58
63
```bash
59
64
# For binary installation
60
65
source /opt/ros/jazzy/setup.bash
@@ -117,27 +122,27 @@ pnpm run start
117
122
118
123
# Contribution guide
119
124
120
-
* For general contribution guidelines, see [CONTRIBUTING](CONTRIBUTING.md).
* When introducing a new feature or component in [`react-components`](packages/react-components), write tests and stories.
123
-
* When introducing a new feature in [`dashboard`](packages/dashboard), write tests as well as [e2e](packages/dashboard-e2e) test whenever possible.
124
-
* When introducing API changes with [`api-server`](packages/api-server),
125
-
* If the new changes are to be used externally (outside of the web packages, with other Open-RMF packages for example), make changes to [`rmf_api_msgs`](https://github.com/open-rmf/rmf_api_msgs), before generating the required models using [this script](packages/api-server/generate-models.sh) with modified commit hashes.
126
-
* Don't forget to update the API client with the newly added changes with [these instructions](packages/api-client/README.md/#generating-rest-api-client).
127
-
* Check out the latest API definitions [here](https://open-rmf.github.io/rmf-web/), or visit `/docs` relative to your running server's url, e.g. `http://localhost:8000/docs`.
128
-
* Develop the frontend without launching any Open-RMF components using [storybook](packages/dashboard/README.md/#storybook).
129
-
* For integration with new devices/infrastructure, check out [Robot Interaction Objects (RIO)](https://github.com/open-rmf/rmf-web/wiki/Robot-Interaction-Objects-(RIO)).
130
-
* Update documentation alongside development, and update the [`ros2multirobotbook`](https://osrf.github.io/ros2multirobotbook) where necessary.
125
+
- For general contribution guidelines, see [CONTRIBUTING](CONTRIBUTING.md).
- When introducing a new feature or component in [`react-components`](packages/react-components), write tests and stories.
128
+
- When introducing a new feature in [`dashboard`](packages/dashboard), write tests as well as [e2e](packages/dashboard-e2e) test whenever possible.
129
+
- When introducing API changes with [`api-server`](packages/api-server),
130
+
- If the new changes are to be used externally (outside of the web packages, with other Open-RMF packages for example), make changes to [`rmf_api_msgs`](https://github.com/open-rmf/rmf_api_msgs), before generating the required models using [this script](packages/api-server/generate-models.sh) with modified commit hashes.
131
+
- Don't forget to update the API client with the newly added changes with [these instructions](packages/api-client/README.md/#generating-rest-api-client).
132
+
- Check out the latest API definitions [here](https://open-rmf.github.io/rmf-web/), or visit `/docs` relative to your running server's url, e.g. `http://localhost:8000/docs`.
133
+
- Develop the frontend without launching any Open-RMF components using [storybook](packages/dashboard/README.md/#storybook).
134
+
- For integration with new devices/infrastructure, check out [Robot Interaction Objects (RIO)](<https://github.com/open-rmf/rmf-web/wiki/Robot-Interaction-Objects-(RIO)>).
135
+
- Update documentation alongside development, and update the [`ros2multirobotbook`](https://osrf.github.io/ros2multirobotbook) where necessary.
131
136
132
137
# Configuration
133
138
134
-
* See the [rmf-dashboard](packages/dashboard/README.md#configuration) docs for the frontend build-time and run-time configurations.
135
-
* See the [api-server](packages/api-server/README.md#configuration) docs for API server run-time configurations.
139
+
- See the [rmf-dashboard](packages/dashboard/README.md#configuration) docs for the frontend build-time and run-time configurations.
140
+
- See the [api-server](packages/api-server/README.md#configuration) docs for API server run-time configurations.
136
141
137
142
# Troubleshooting
138
143
139
-
* If a feature is missing or is not working, it could be only available in an Open-RMF source build, and not in the binaries. Try building Open-RMF from source and source that new workspace before launching the API server. `rmf-web` may use in-development features of Open-RMF.
144
+
- If a feature is missing or is not working, it could be only available in an Open-RMF source build, and not in the binaries. Try building Open-RMF from source and source that new workspace before launching the API server. `rmf-web` may use in-development features of Open-RMF.
140
145
141
-
* Creating tasks from the web dashboard when running a simulated Open-RMF deployment will require the task start time suit simulation time, which starts from unix millis 0. Try creating the same task with a start date of before the year of 1970.
146
+
- Creating tasks from the web dashboard when running a simulated Open-RMF deployment will require the task start time suit simulation time, which starts from unix millis 0. Try creating the same task with a start date of before the year of 1970.
142
147
143
-
* Check if the issue has already been [reported or fixed](https://github.com/open-rmf/rmf-web/issues).
148
+
- Check if the issue has already been [reported or fixed](https://github.com/open-rmf/rmf-web/issues).
0 commit comments