README.md
[](https://codeclimate.com/github/maestro-server/client-app) [](https://travis-ci.com/maestro-server/client-app) [](https://codeclimate.com/github/maestro-server/client-app)
[](https://www.codacy.com/gh/maestro-server/client-app/dashboard?utm_source=github.com&utm_medium=referral&utm_content=maestro-server/client-app&utm_campaign=Badge_Grade)
# Maestro Server #
Maestro Server is an open source software platform for management and discovery servers, apps and system for Hybrid IT. Can manage small and large environments, be able to visualize the latest multi-cloud environment state.
### Demo ###
To test out the demo, [Demo Online](http://demo.maestroserver.io "Demo Online")
# Maestro Server - Client APP #
The front end application, made using Vue2.
* Html and Js client
* Single page app (SPA)
* Cache layer
## Tools
| Name | Description |
|----------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| Vue2 | Main framework, using by react and manager views, routes and temaplates, use vue-loader with webpack |
| Webpack2 | bundler generate |
| Bootue | All micro components, like buttons, tables, forms and etc, its 100% Bootstrap3 components built with Vue2, 100% standalone, no query. |
| Nginx | Using for proxy reverse |
| Mocha / Chai / Sinon | Test, asserts and mock library.
For detailed explanation on how things work, checkout the [guide](http://vuejs-templates.github.io/webpack/) and [docs for vue-loader](http://vuejs.github.io/vue-loader). |
## Build Setup
``` bash
# install dependencies
npm install
# serve with hot reload at localhost:8080
npm run dev
# build for production with minification
npm run build
# build for production and view the bundle analyzer report
npm run build --report
# run unit tests
npm run unit
# run e2e tests
npm run e2e
# run all tests
npm test
```
## Vue2 Macro Architecture
#### Important topics
Front end application is divided in:
* **src/pages:** templates and bussiness rules (domain layer)
* **resources:** factories, modals, and cache managers (infrastructure layer)
A single folder structure components normally use:
### Env variables ###
| Env Variables | Example | Description |
|---------------|--------------------------|---------------------------------|
| API_URL | http://localhost:8888 | Server App Url |
| ANALYTICS_URL | http://localhost:9999 | Analytics App Url |
| STATIC_URL | /static/ | Static path, |
| LOGO | /static/imgs/logo300.png | Image Logotype, (login page) |
| THEME | lotus | Themes (gold, wine, blue, green)|
### Contribute ###
Are you interested in developing Maestro Server, creating new features or extending them?
We created a set of documentation, explaining how to set up your development environment, coding styles, standards, learn about the architecture and more. Welcome to the team and contribute with us.
[See our developer guide](http://docs.maestroserver.io/en/latest/contrib.html)
### Contact ###
We may be able to resolve support queries via email. [Please send me a message here](https://maestroserver.typeform.com/to/vf6sGR)
### Donate ###
I have made Maestro Server with my heart, think to solve a real operation IT problem. Its not easy, take time and resources.
The donation will be user to:
- Create new features, implement new providers.
- Maintenance libs, securities flaws, and technical points.
<a href="https://www.buymeacoffee.com/9lVypB7WQ" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/purple_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
### Sponsor ###
[<img src="docs/_imgs/jetbrains.png" width="100">](https://www.jetbrains.com/?from=maestroserver)