{"id":13602468,"url":"https://github.com/rancher/ui","last_synced_at":"2026-03-09T19:18:37.089Z","repository":{"id":24743330,"uuid":"28155823","full_name":"rancher/ui","owner":"rancher","description":"Rancher UI","archived":false,"fork":false,"pushed_at":"2025-03-21T15:50:40.000Z","size":66648,"stargazers_count":603,"open_issues_count":10,"forks_count":484,"subscribers_count":44,"default_branch":"master","last_synced_at":"2025-03-21T23:35:46.948Z","etag":null,"topics":["cattle","ember","rancher","ui"],"latest_commit_sha":null,"homepage":"http://rancher.com","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rancher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-12-17T21:13:03.000Z","updated_at":"2025-03-05T11:11:41.000Z","dependencies_parsed_at":"2024-03-11T22:35:09.396Z","dependency_job_id":"544bc455-2efb-4e1c-9fc2-ba4ed9775802","html_url":"https://github.com/rancher/ui","commit_stats":{"total_commits":8197,"total_committers":181,"mean_commits":45.28729281767956,"dds":0.7173356105892399,"last_synced_commit":"24470735dfd355a0dc2be491e56ff114eb3903e6"},"previous_names":[],"tags_count":900,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rancher%2Fui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rancher%2Fui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rancher%2Fui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rancher%2Fui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rancher","download_url":"https://codeload.github.com/rancher/ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631670,"owners_count":21136554,"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":["cattle","ember","rancher","ui"],"created_at":"2024-08-01T18:01:24.349Z","updated_at":"2026-01-27T23:15:14.627Z","avatar_url":"https://github.com/rancher.png","language":"JavaScript","readme":"Rancher UI\n--------\n\nThis is the source code repository for the original Rancher UI.\n\nThe new Rancher UI source code can be found here - https://github.com/rancher/dashboard\n\nThis UI is being phased out and we plan to retire it completely in 2026, thus, we are not accepting new Pull Requests from external contributors.\n\n## Usage\n\nPrerequisites:\n* [Python](https://www.python.org/downloads) v3.8 - 3.10\n* [Git](http://git-scm.com/)\n* [Node.js](http://nodejs.org/) 8.x - 14.x (with NPM)\n* [Yarn](https://yarnpkg.com/en/docs/install) (Note Path Setup)\n\nIf you're on a Mac and use Homebrew, you can follow these steps:\n```bash\n  brew install node watchman yarn\n```\n\nSetup:\n```bash\n  git clone 'https://github.com/rancher/ui'\n  cd 'ui'\n  ./scripts/update-dependencies\n```\n\nRun development server:\n```bash\n  yarn start\n```\n\nConnect to UI at https://localhost:8000/ .  The server automatically picks up file changes, restarts itself, and reloads the web browser.  This is intended only for development, see below for distributing customizations.\n\nRun development server pointed at another instance of the Rancher API\n```bash\n  RANCHER=\"https://rancher-server\" yarn start\n```\n\nRANCHER can also be `hostname[:port]` or `ip[:port]`.\n\n### Compiling for distribution\n\nRancher releases include a static copy of the UI passed in during build as a tarball.  To generate that, run:\n```bash\n  ./scripts/build-static\n```\n### Customizing\n\nWe highly suggest making customizations as an [ember-cli addon](http://ember-cli.com/extending/#developing-addons-and-blueprints) rather than forking this repo, making a bunch of changes and then fighting conflicts to keep it up to date with upstream forever.  [ui-driver-skel](https://github.com/rancher/ui-driver-skel) is an example addon that adds a custom screen for a docker-machine driver.  If there is no way for you to get to what you want to change from an addon, PRs to this repo that add generalized hooks so that you can are accepted.\n\n### Project Structure\n\nRancher UI uses [Ember CLI Pods](https://cli.emberjs.com/release/advanced-use/project-layouts/#podslayout) for its project structure. We suggest reading the documentation if you have questions about the layout of the Rancher UI project.\n\n### Engines and In-repo Addons\n\nRancher UI uses [Ember Engines](http://ember-engines.com) to break the deliverable code into smaller chunks and only deliver what the end-user will need. When adding new components to an engine ensure you are only re-exporting the component back out of the engine if it is required and can not be placed in the `shared` in-repo addon. When adding a new service or dependency that is required by an engine ensure that you pass the dependencies to the engine, more info can be found [here](http://ember-engines.com/guide/services)\n\nThe `shared` in-repo addon is a central repository of shared components for use with both the main app and any in-repo engine.\n\n### Translations\nRancher UI supports localization via translations files. You can swap translations live by utilizing the Language Picker located in the footer. If you would like to add your own translations files follow the directions below.\n\n- Fork the Rancher UI repo\n- Copy the ```en-us.yaml``` file located in ```/translations``` folder and rename using the ```\u003clanguage-code\u003e/\u003ccountry-code\u003e.yaml``` format ([Supported Locales](https://github.com/andyearnshaw/Intl.js/tree/master/locale-data/jsonp))\n- Replace the values on each key with you're new values corresponding to your language\n- Ensure you replace the ```languageName``` value as this is what will be displayed in the language picker in the UI\n- While developing you can use ```SHFT + L``` when not focused in an input or text area to toggle the languages between your currently selected language and a special *none* language to see what key values are missing\n- When you've finished you're translations issue a pull request back to the Rancher UI repo to have your translation included\n\n### Hosting remotely\n\nIf you want to customize the UI, re-packaging all of Rancher to distribute the UI is possible but not terribly convenient. Instead you can change Cattle to load the UI source from a remote web server:\n\n- Build with `./scripts/build-static -l -c 'your-server.com'`\n- Upload `./dist/static/latest2` so that it's available at https://your-server.com/latest2\n  - It must be available over HTTPS.\n  - You can rename the \"latest2\" part with the `-v` flag\n- Change the value of https://your-rancher/v3/settings/ui-index to the same `https://your-server.com/latest2` URL\n\n### Running Tests\n\n```bash\n  yarn global add ember-cli\n```\n\n* `yarn lint:hbs`\n* `yarn lint:js`\n* `yarn lint:js -- --fix`\n\n* `ember test`\n* `ember test --server`\n\n### Bugs \u0026 Issues\nPlease submit bugs and issues to [rancher/dashboard](//github.com/rancher/dashboard/issues) and add the issue label `ember`.\n\nOr just [click here](//github.com/rancher/dashboard/issues/new/choose) to create a new issue.\n\n\n#### Useful links\n\n* ember: http://emberjs.com/\n* ember-cli: http://www.ember-cli.com/\n* ember-engines: http://ember-engines.com/\n* Development Browser Extensions\n  * [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)\n  * [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)\n\nLicense\n=======\nCopyright (c) 2014-2026 [SUSE](http://www.suse.com)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","funding_links":[],"categories":["JavaScript","Packages"],"sub_categories":["Examples"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Francher%2Fui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Francher%2Fui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Francher%2Fui/lists"}