ha-frontend/README.md

39 lines
2.0 KiB
Markdown
Raw Normal View History

2020-03-02 13:40:45 +01:00
# Home Assistant Frontend
2015-07-13 07:38:54 +02:00
This is the repository for the official [Home Assistant](https://home-assistant.io) frontend.
2015-07-13 07:38:54 +02:00
2019-11-21 15:05:42 +01:00
[![Screenshot of the frontend](https://raw.githubusercontent.com/home-assistant/home-assistant-polymer/master/docs/screenshot.png)](https://demo.home-assistant.io/)
2015-07-13 07:38:54 +02:00
2019-11-21 15:05:42 +01:00
- [View demo of Home Assistant](https://demo.home-assistant.io/)
2018-05-18 19:21:59 +02:00
- [More information about Home Assistant](https://home-assistant.io)
- [Frontend development instructions](https://developers.home-assistant.io/docs/en/frontend_index.html)
2015-07-13 07:54:50 +02:00
2018-07-19 21:12:59 +02:00
## Development
- Initial setup: `script/setup`
- Development: [Instructions](https://developers.home-assistant.io/docs/en/frontend_development.html)
- Production build: `script/build_frontend`
- Gallery: `cd gallery && script/develop_gallery`
- Hass.io: [Instructions](https://developers.home-assistant.io/docs/en/hassio_hass.html)
## Frontend development
### Classic environment
A complete guide can be found at the following [link](https://www.home-assistant.io/developers/frontend/). It describes a short guide for the build of project.
### Docker environment
It is possible to compile the project and/or run commands in the development environment having only the [Docker](https://www.docker.com) pre-installed in the system. On the root of project you can do:
- `sh ./script/docker_run.sh build` Build all the project with one command
- `sh ./script/docker_run.sh bash` Open an interactive shell (the same environment generated by the _classic environment_) where you can run commands. This bash work on your project directory and any change on your file is automatically present within your build bash.
**Note**: if you have installed `npm` in addition to the `docker`, you can use the commands `npm run docker_build` and `npm run bash` to get a full build or bash as explained above
2015-07-13 07:38:54 +02:00
## License
2018-07-19 21:12:59 +02:00
Home Assistant is open-source and Apache 2 licensed. Feel free to browse the repository, learn and reuse parts in your own projects.
2019-11-21 15:05:42 +01:00
We use [BrowserStack](https://www.browserstack.com) to test Home Assistant on a large variation of devices.