Configuring themes in edX

For each of our applications, we have a theme that overrides the branding in our legacy edX pages:

MITx Online theme: https://github.com/mitodl/mitxonline-theme
MITx Pro theme: https://github.com/mitodl/mitxpro-theme
Residential theme: https://github.com/mitodl/mitx-theme

In edx-platform, add the following in your private.py file:

MARKETING_SITE_BASE_URL = <Your local marketing site url, for example, for MITxPRO we have http://xpro.odl.local:8053>

# For MITx Online only
UAI_COURSE_KEY_FORMATS = ["course-v1:uai_", "course-v1:mit_et"]
MIT_LEARN_BASE_URL = "https://learn.mit.edu"
MIT_BASE_URL = "https://mit.edu"

Navigate to the Tutor Project Root Directory

Run the following command to go to the Tutor root path:
```
cd "$(tutor config printroot)"
```
Clone the Theme Repository

Go to the following directory inside the Tutor root:
```
cd env/build/openedx/themes/
```
Then clone the theme repo inside this folder.
```
git clone <theme-repo-url for e.g, https://github.com/mitodl/mitxonline-theme>
```
Apply the Theme

Run this command to apply your custom theme:
```
tutor dev do settheme <theme-name for e.g, mitxonline-theme>
```
Restart the LMS/CMS container.
Run the theme watcher

Watch the themes folders for changes:
```
tutor dev run watchthemes
```

Other Settings (Not required for local setup)

The configuration above is enough to run the themes locally. Below are some of the settings required for deployments:

ENABLE_COMPREHENSIVE_THEMING: When enabled, this toggle activates the use of the custom theme.
COMPREHENSIVE_THEME_DIRS: A list of paths to directories, each of which will be searched for comprehensive themes.