{"id":14037369,"url":"https://github.com/openhab/openhab-webui","last_synced_at":"2025-05-16T06:06:09.969Z","repository":{"id":37601627,"uuid":"171155857","full_name":"openhab/openhab-webui","owner":"openhab","description":"Web UIs of openHAB","archived":false,"fork":false,"pushed_at":"2025-05-12T09:40:07.000Z","size":46208,"stargazers_count":239,"open_issues_count":329,"forks_count":252,"subscribers_count":25,"default_branch":"main","last_synced_at":"2025-05-12T10:47:02.644Z","etag":null,"topics":["java","javascript","openhab","smarthome","vue"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openhab.png","metadata":{"funding":{"custom":["https://www.openhab.org/about/donate.html"]},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-02-17T18:19:51.000Z","updated_at":"2025-05-05T08:46:31.000Z","dependencies_parsed_at":"2022-07-14T05:30:37.046Z","dependency_job_id":"57dd0f37-3b1e-417f-a814-e18cdb4a5571","html_url":"https://github.com/openhab/openhab-webui","commit_stats":null,"previous_names":[],"tags_count":113,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openhab%2Fopenhab-webui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openhab%2Fopenhab-webui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openhab%2Fopenhab-webui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openhab%2Fopenhab-webui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openhab","download_url":"https://codeload.github.com/openhab/openhab-webui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478189,"owners_count":22077676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","javascript","openhab","smarthome","vue"],"created_at":"2024-08-12T03:02:45.870Z","updated_at":"2025-05-16T06:06:04.953Z","avatar_url":"https://github.com/openhab.png","language":"Vue","funding_links":["https://www.openhab.org/about/donate.html"],"categories":["Vue"],"sub_categories":[],"readme":"# openHAB Web Interface Add-ons\n\n\u003cimg align=\"right\" width=\"220\" src=\"./logo.svg\" type=\"image/svg+xml\"/\u003e\n\n[![GitHub Actions Build Status](https://github.com/openhab/openhab-webui/actions/workflows/ci-build.yml/badge.svg?branch=main)](https://github.com/openhab/openhab-webui/actions/workflows/ci-build.yml)\n[![Jenkins Build Status](https://ci.openhab.org/job/openHAB-WebUI/badge/icon)](https://ci.openhab.org/job/openHAB-WebUI/)\n[![EPL-2.0](https://img.shields.io/badge/license-EPL%202-green.svg)](https://opensource.org/licenses/EPL-2.0)\n[![Crowdin](https://badges.crowdin.net/openhab-webui/localized.svg)](https://crowdin.com/project/openhab-webui)\n\nThis repository contains the official web user interfaces for openHAB.\n\nopenHAB has a main web UI but more can be installed thanks to its modular add-on architecture.\n\nMost UIs rely on openHAB's REST API which is largely implemented in openHAB Core bundles, but sometimes on individual add-ons.\nTherefore, a significant chunk of issues that can be mistakenly assumed to be UI issues could in fact be depending on an extension of the REST API.\n\nIf your issue is not strictly UI-related be aware it could eventually be transferred or closed with an indication that it requires a change in openHAB Core to be implemented.\nShould you be interested in openHAB Core development, we invite you to check out https://github.com/openhab/openhab-core.\n\nThat being said, if you feel you have a genuine problem with one of the web UIs, please review the existing issues at https://github.com/openhab/openhab-webui/issues first, then file a new one at https://github.com/openhab/openhab-webui/issues/new/choose if appropriate - the menu will guide you.\n\n## Development / Repository Organization\n\nopenHAB add-ons are [Java](https://en.wikipedia.org/wiki/Java_(programming_language)) `.jar` files.\n\nThe openHAB build system is based on [Maven](https://maven.apache.org/what-is-maven.html).\nThe official IDE (Integrated development environment) is Eclipse.\n\nYou find the following repository structure:\n\n```\n.\n+-- bom       Maven buildsystem: Bill of materials\n|   +-- openhab-ui  Lists all extensions\n|\n+-- bundles   Official openHAB web interface extensions\n|   +-- org.openhab.ui\n|   +-- org.openhab.ui.basicui\n|   +-- org.openhab.ui.habot\n|   +-- org.openhab.ui.habpanel\n|   +-- ...\n|\n+-- features  Part of the runtime dependency resolver (\"Karaf features\")\n|\n+-- licenses  Infrastructure to easily add license headers to source files\n|\n+-- tools     Static code analyser instructions\n|\n+-- CODEOWNERS  This file assigns people to directories so that they are informed\n|   if a pull-request would modify their add-ons.\n|\n+-- LICENSE   The official license for this repository.\n```\n\n### How to contribute\n\nIn most cases, you **don't** need a Java development environment for UI development.\n\nInstead, you need NodeJS and npm installed, you'll learn about the required versions later.\n\nThen identify in the `bundles` directories where the frontend code is - for instance, for the Main UI it is `bundles/org.openhab.ui/web/`.\nThen follow the instructions in the specific add-on's `CONTRIBUTING.md` file to get started, e.g. install the correct versions of NodeJS and npm.\nFor Main UI, it is located in [bundles/org.openhab.ui/CONTRIBUTING.md](https://github.com/openhab/openhab-webui/blob/master/bundles/org.openhab.ui/CONTRIBUTING.md).\nIn many cases it will involve executing some `npm` commands to install dependencies and start a development server.\n\nHowever, if you want to compile the final `.jar` add-ons, we have assembled some step-by-step guides for different IDEs on our developer documentation website:\n\nhttps://www.openhab.org/docs/developer/#setup-the-development-environment\n\n### Command line build\n\nTo build all add-ons from the command-line, type in:\n\n`mvn clean install`\n\nTo improve build times you can add the following options to the command:\n\n| Option                        | Description                                         |\n| ----------------------------- | --------------------------------------------------- |\n| `-DskipChecks`                | Skip the static analysis (Checkstyle, FindBugs)     |\n| `-DskipTests`                 | Skip the execution of tests                         |\n| `-Dmaven.test.skip=true`      | Skip the compilation and execution of tests         |\n| `-Dfeatures.verify.skip=true` | Skip the Karaf feature verification                 |\n| `-Dspotless.check.skip=true`  | Skip the Spotless code style checks                 |\n| `-o`                          | Work offline so Maven does not download any updates |\n| `-T 1C`                       | Build in parallel, using 1 thread per core          |\n\nFor example you can skip checks and tests during development with:\n\n`mvn clean install -DskipChecks -DskipTests`\n\nAdding these options improves the build time but could hide problems in your code.\nParallel builds are also less easy to debug and the increased load may cause timing sensitive tests to fail.\n\nTo check if your code is following the [code style](https://www.openhab.org/docs/developer/guidelines.html#b-code-formatting-rules-style) run: `mvn spotless:check`\nTo reformat your code so it conforms to the code style you can run: `mvn spotless:apply`\n\nWhen your add-on also has an integration test in the `itests` directory, you may need to update the runbundles in the `itest.bndrun` file when the Maven dependencies change.\nMaven can resolve the integration test dependencies automatically by executing: `mvn clean install -DwithResolver -DskipChecks`\n\nThe build generates a `.jar` file per bundle in the respective bundle `/target` directory.\n\n**Happy coding! 🎉**\n\n\u003csmall\u003e[\u003cimg align=\"right\" src=\"https://user-images.githubusercontent.com/2004147/30233170-35d19c3a-94f4-11e7-8540-894977d1c653.png\"\u003e](https://www.browserstack.com/) Thanks to [BrowserStack](https://www.browserstack.com/) for kindly providing the maintainers with free open source accounts to help testing the UIs on a wide range of devices!\u003c/small\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenhab%2Fopenhab-webui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenhab%2Fopenhab-webui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenhab%2Fopenhab-webui/lists"}