Links marked with this icon :door: are _internal to Red Hat_. This includes Jenkins servers, job configs in gitlab, and container sources in dist-git. 

Because these services are internal, in the interest of making all things open, we've copied as much as possible into the link:https://github.com/redhat-developer/devspaces-images[devspaces-images] repo.

## What's inside?

NOTE: The so-called master branch is deprecated and is no longer kept up to date. Instead, the latest nightly sources are in **devspaces-3-rhel-9 branch**, synced to upstream projects' main (or master) branches.

For the latest stable release, see the **devspaces-3.y-rhel-9** branch with the largest y value.


## How to build locally

1. Sync code from upstream using `build/scripts/sync.sh`.

2. Build the Dashboard image using `build/dockerfiles/rhel.Dockerfile`.

## How to build in Brew

1. To build in Brew, see the `get-sources*.sh` script, which will:

* build the dashboard image locally, extract the yarn cache into a tarball, then
* trigger a Brew build using that tarball.

## Branding

Branding is currently in two places.

### Dashboard

To reskin link:https://github.com/eclipse-che/che-dashboard/tree/main/packages/dashboard-frontend/assets/branding[Che Dashboard], edit the following files:

* link:packages/dashboard-frontend/assets/branding/branding-devspaces.css[packages/dashboard-frontend/assets/branding/branding-devspaces.css] - replacement for link:https://github.com/eclipse-che/che-dashboard/tree/main/packages/dashboard-frontend/assets/branding/branding.css[Che default css], copied via link:https://github.com/redhat-developer/devspaces-images/blob/devspaces-3-rhel-9/devspaces-dashboard/build/scripts/sync.sh#L114[build/scripts/sync.sh].
* link:packages/dashboard-frontend/assets/branding/product.json.template[packages/dashboard-frontend/assets/branding/product.json.template] - includes variable links to DS docs
* link:packages/dashboard-frontend/assets/branding/favicon.ico[packages/dashboard-frontend/assets/branding/favicon.ico] - browser tab favicon
* link:packages/dashboard-frontend/assets/branding/che-logo-text.svg[packages/dashboard-frontend/assets/branding/che-logo-text.svg] - top left wordmark
* link:packages/dashboard-frontend/assets/branding/che-logo.svg[packages/dashboard-frontend/assets/branding/che-logo.svg] - bottom left icon
* link:packages/dashboard-frontend/assets/branding/loader.svg[packages/dashboard-frontend/assets/branding/loader.svg] - dashboard loading animation

See also SVG assets in link:packages/dashboard-frontend/assets/branding/[packages/dashboard-frontend/assets/branding/] folder.

### Microsoft Visual Studio Code - Open Source IDE

To reskin link:https://github.com/che-incubator/che-code/[che-code], which is built from link:https://github.com/microsoft/vscode[Microsoft Visual Studio Code - Open Source IDE], see https://github.com/redhat-developer/devspaces-images/tree/devspaces-3-rhel-9/devspaces-code/branding[devspaces-images/devspaces-code/branding].

### A note about SVG files 

If using Inkscape to save files, make sure you export as *Plain SVG*, then edit the resulting .svg file to remove any `<metadata>...</metadata>` tags and all their contents. You can also remove the `xmlns:rdf` definition. This will ensure they compile correctly.
