xref: /openbmc/webui-vue/README.md (revision 4b0fc1db)
1# webui-vue
2
3webui-vue is a web-based user interface for the OpenBMC firmware stack built on
4[Vue.js](https://vuejs.org/).
5
6### Hold on... What happened to phosphor-webui?
7
8[phosphor-webui](https://github.com/openbmc/phosphor-webui) was built on
9AngularJS and [AngularJS goes End of Life](https://www.convective.com/angularjs-end-of-life/)
10June 30, 2021, so this repository is hopefully its replacement. At this time,
11phosphor-webui still contains more features and you should consider using it.
12
13### When will this new Vue.js application reach feature parity with phosphor-webui?
14
15The current plan is by June 2020!
16
17### Why will this application be better?
18
19As mentioned, this application is built using Vue.js, a modern open-source
20Model-View-ViewModel JavaScript framework supported by an active community and
21strong documentation. It has been architected to allow organizations to easily
22update the theme to support their brand. This rewrite takes advantage of
23front-end development best practices and does not suffer from some of the
24anti-patterns that exist in phosphor-webui today.
25
26### How can I get involved?
27
28Visit the [CONTRIBUTING.md](CONTRIBUTING.md) for more on how to contribute code,
29review some code in
30[Gerrit](https://gerrit.openbmc-project.xyz/q/project:openbmc%252Fwebui-vue+status:open),
31or join us in the
32[GUI design workgroup meeting](https://github.com/openbmc/openbmc/wiki/GUI-Design-work-group).
33
34### Project setup
35
36```
37npm install
38```
39
40#### Compiles and hot-reloads for development
41
42```
43npm run serve
44```
45
46#### Compiles and minifies for production
47
48```
49npm run build
50```
51
52#### Run your unit tests
53
54```
55npm run test:unit
56```
57
58#### Lints and fixes files
59
60```
61npm run lint
62```
63