xref: /openbmc/webui-vue/docs/guide/readme.md (revision 7a57faae)
1---
2sidebarDepth: 0
3---
4
5# Getting Started
6
7This guide outlines the architecture and technologies used to build the OpenBMC
8Web UI. This guide exists to serve the following goals:
9
101. Improve contributor efficiency while maintaining the quality and consistency
11   of the user interface
121. Act as a collection of community agreed-upon standards
13
14## Coding Standards
15Having an understanding of semantic HTML, CSS, and JavaScript is the critical
16knowledge required to contribute to this project. The frameworks and libraries
17used to build this UI include:
18- [Vue](https://vuejs.org/)
19- [Vuex](https://vuex.vuejs.org/)
20- [Vue Router](https://router.vuejs.org/)
21- [Axios](https://github.com/axios/axios)
22- [Bootstrap-vue](https://bootstrap-vue.js.org/)
23- [Vuelidate](https://vuelidate.js.org/)
24- [Vue I18n](https://kazupon.github.io/vue-i18n/)
25
26::: tip Acquiring an understanding of these technologies will also be necessary.
27:::
28
29You will find more information about the standards and best practices in the
30[Coding Standards section of this guide](/guide/coding-standards/).
31
32## Guidelines
33The [guidelines section](/guide/guidelines/colors) contains the OpenBMC
34community agreed-upon decisions on color, motion, and typography within the
35application. How to theme the application to meet company brand guidelines is
36documented in [Themes](/themes).
37
38## Components
39The [components section](/guide/components/) is a guide to using both custom Vue
40components and components from the Bootstrap-Vue library.
41
42