summaryrefslogtreecommitdiff
path: root/README.md
blob: 80da456d435e2e58b85e3497d97ab9b3b4e456bb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# webui-vue

webui-vue is a web-based user interface for the OpenBMC firmware stack built on
[Vue.js](https://vuejs.org/).

## Hold on... What happened to phosphor-webui?

[phosphor-webui](https://github.com/openbmc/phosphor-webui) was built on
AngularJS and
[AngularJS goes End of Life](https://www.convective.com/angularjs-end-of-life/)
June 30, 2021, this repository is its replacement.

## When will this new Vue.js application reach feature parity with phosphor-webui?

Several, mostly minor, features remain for feature parity. See
[GitHub Issues label:phosphor-webui-feature-parity](https://github.com/openbmc/webui-vue/issues?q=is%3Aissue+is%3Aopen+label%3Aphosphor-webui-feature-parity)
for the complete list.

## Why will this application be better?

As mentioned, this application is built using Vue.js, a modern open-source
Model-View-ViewModel JavaScript framework supported by an active community and
strong documentation. It has been architected to allow organizations to easily
update the theme to support their brand. This rewrite takes advantage of
front-end development best practices and does not suffer from some of the
anti-patterns that exist in phosphor-webui today.

## Should I switch to webui-vue from phosphor-webui?

That is up to you. Several companies have switched.

- [Commit moving several systems to webui-vue](https://github.com/openbmc/openbmc/commit/4a3fa4d6d865b46ba54f2652c82f58a406455ebc)
- [Discussion about webui-vue being the standard](https://lists.ozlabs.org/pipermail/openbmc/2020-September/023160.html)

webui-vue although still missing a few features that were in phosphor-webui, as
mentioned above, has the following additional features:

- Ability to easily theme to meet brand guidelines
- Accessibility
- Full Redfish
- Improved user experience based on user feedback
- Language translation-ready
- Modern front-end framework with an active community and future development
  roadmap

## How can I get involved?

- Visit the [CONTRIBUTING.md](CONTRIBUTING.md) for more on how to contribute
  code
- Review some code in
  [Gerrit](https://gerrit.openbmc-project.xyz/q/project:openbmc%252Fwebui-vue+status:open)
- Join us in the
  [GUI design workgroup meeting](https://github.com/openbmc/openbmc/wiki/GUI-Design-work-group).

## Documentation

The documentation for coding standards and components is located in the `docs`
directory. It is created using the [VuePress](https://vuepress.vuejs.org/)
static site generator. Information about how to write documentation can be found
on the [VuePress website](https://vuepress.vuejs.org/).