Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Set edx.org theme as default for edx-platform and MFEs #67

Merged
merged 4 commits into from
Jan 29, 2025
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -707,6 +707,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-account'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-account"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -722,6 +724,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-profile'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-profile"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As is, this will pull from latest, which could introducing breaking changes unintentionally if a new major version is released.

Suggested change
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org@~2.0.0'

https://github.com/edx/edx-internal/blob/b3bd6adf8407b986349272f33b37922c620d8857/frontends/frontend-app-profile/prod_config.yml#L26

networks:
default:
aliases:
Expand All @@ -737,6 +741,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-authn'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-authn"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -752,6 +758,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-course-authoring'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-course-authoring"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It appears this MFE does not install @edx/brand-edx.org in the standard way, instead manually installing it in the gocd pipeline itself (source).

That said, it currently installs 2.x, not latest.

networks:
default:
aliases:
Expand All @@ -767,6 +775,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-gradebook'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-gradebook"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: it doesn't appear frontend-app-gradebook uses @edx/brand-edx.org today. See production app in screenshot below; the button styles are from the default Paragon styles, not @edx/brand-edx.org.

Would we want to update the devstack MFE to use @edx/brand-edx.org when stage/prod does not? For this PR, I might recommend not adding @edx/brand-edx.org for MFEs that seemingly don't use it. You might consider coordinating with the owning teams to start using the @edx/brand-edx.org theme in stage/prod/devstack.

image

networks:
default:
aliases:
Expand All @@ -782,6 +792,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-ora-grading'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-ora-grading"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -797,6 +809,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-learner-dashboard'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-learner-dashboard"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -812,6 +826,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-learner-record'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-learner-record"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -827,6 +843,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-learning'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-learning"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org@2.1.3'
networks:
default:
aliases:
Expand All @@ -842,6 +860,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-library-authoring'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-library-authoring"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here's another instance where @edx/brand-edx.org is actually installed via the GoCD pipeline file vs. the typical NPM_ALIASES config (source). That said, the version appears to be 2.x.

networks:
default:
aliases:
Expand All @@ -858,6 +878,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-payment'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-payment"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand All @@ -873,6 +895,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-program-console'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-program-console"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: @edx/brand-edx.org@2

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The update file contains the value @edx/brand-edx.org@1.x, which I updated from this source.

networks:
default:
aliases:
Expand All @@ -889,6 +913,8 @@ services:
service: microfrontend
working_dir: '/edx/app/frontend-app-publisher'
container_name: "edx.${COMPOSE_PROJECT_NAME:-devstack}.frontend-app-publisher"
environment:
PARAGON_BRAND_PACKAGE: '@edx/brand-edx.org'
networks:
default:
aliases:
Expand Down
13 changes: 12 additions & 1 deletion microfrontend.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,18 @@ services:
#
# Fail fast if package install fails to avoid mysterious
# errors later.
command: bash -c 'npm ci || exit 1; while true; do npm start; sleep 2; done'
command:
- bash
- -c
- |
npm ci || exit 1
if [ -n "$(printenv PARAGON_BRAND_PACKAGE)" ]; then
npx paragon install-theme "$(printenv PARAGON_BRAND_PACKAGE)" || exit 1
Comment on lines +24 to +25
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great; seems to work well locally.

fi
while true; do
npm start
sleep 2
done
stdin_open: true
tty: true
image: node:18
Expand Down
3 changes: 3 additions & 0 deletions provision-lms.sh
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,9 @@ done
# Fix missing vendor file by clearing the cache
# docker compose exec -T lms bash -e -c 'rm /edx/app/edxapp/edx-platform/.prereqs_cache/Node_prereqs.sha1'

# Set edX theme in LMS and CMS.
./provision-set-edx-theme.sh

# Create static assets for both LMS and CMS
for app in "${apps[@]}"; do
make "dev.static.$app"
Expand Down
47 changes: 47 additions & 0 deletions provision-set-edx-theme.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
#!/usr/bin/env bash

# This script sets up the edX theme in LMS and CMS.

REPO_URL="https://github.com/edx/edx-themes"
THEME_DIR="/edx/src/edx-themes/edx-platform"
DEVSTACK_FILE="../edx-platform/lms/envs/devstack.py"

# Clone the edx-themes repository into the src directory
cd ../src
if [ ! -d "edx-themes" ]; then
git clone "$REPO_URL"
else
echo "Directory 'edx-themes' already exists. Skipping clone."
fi
cd ../devstack

# Uncomment relevant lines in the devstack.py file
sed -i '' "s|^# from .common import _make_mako_template_dirs|from .common import _make_mako_template_dirs|" "$DEVSTACK_FILE"
sed -i '' "s|^# ENABLE_COMPREHENSIVE_THEMING = True|ENABLE_COMPREHENSIVE_THEMING = True|" "$DEVSTACK_FILE"
sed -i '' "s|^# COMPREHENSIVE_THEME_DIRS = \[|COMPREHENSIVE_THEME_DIRS = \[|" "$DEVSTACK_FILE"
sed -i '' "s|^# \"/edx/app/edxapp/edx-platform/themes/\"| \"/edx/app/edxapp/edx-platform/themes/\",|" "$DEVSTACK_FILE"
sed -i '' "/COMPREHENSIVE_THEME_DIRS = \[/a\\
\"$THEME_DIR\",
" "$DEVSTACK_FILE"
sed -i '' "s|^# \]|]|" "$DEVSTACK_FILE"
sed -i '' "s|^# TEMPLATES\[1\]\[\"DIRS\"\] = _make_mako_template_dirs|TEMPLATES[1][\"DIRS\"] = _make_mako_template_dirs|" "$DEVSTACK_FILE"
sed -i '' "s|^# derive_settings(__name__)|derive_settings(__name__)|" "$DEVSTACK_FILE"


# Add the theme directory to COMPREHENSIVE_THEME_DIRS if not already present
if ! grep -qF "$THEME_DIR" "$DEVSTACK_FILE"; then
sed -i '' "/COMPREHENSIVE_THEME_DIRS = \[/a\\
\"$THEME_DIR\",
" "$DEVSTACK_FILE"
fi

# Set the theme site-wide
SERVICE_NAME="mysql80"
DATABASE="edxapp"
THEME_NAME="edx.org-next"
SITE_ID=1

docker compose exec -T "$SERVICE_NAME" mysql -e "
USE $DATABASE;
INSERT INTO theming_sitetheme (theme_dir_name, site_id) VALUES ('$THEME_NAME', $SITE_ID);
"
Loading