Skip to content

docs: Streamlined brand README#48

Open
kdmccormick wants to merge 2 commits into
mainfrom
kdmccormick/brand-readme
Open

docs: Streamlined brand README#48
kdmccormick wants to merge 2 commits into
mainfrom
kdmccormick/brand-readme

Conversation

@kdmccormick
Copy link
Copy Markdown
Member

@kdmccormick kdmccormick commented May 16, 2026

Sorts the instructions in the README more explicitly and makes some steps more copy-able.

The only hole left is "Local brand dev without Tutor". I'm working on this now.

Preview: https://github.com/openedx/sample-plugin/blob/kdmccormick/brand-readme/brand-sample/README.md

No AI use.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 16, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.04%. Comparing base (d4f3801) to head (ea89d01).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #48   +/-   ##
=======================================
  Coverage   93.04%   93.04%           
=======================================
  Files          16       16           
  Lines         503      503           
  Branches       18       18           
=======================================
  Hits          468      468           
  Misses         24       24           
  Partials       11       11           
Flag Coverage Δ
unittests 93.04% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment thread brand-sample/README.md

### Local brand dev without Tutor

TODO write this section
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

2U's elm-theme includes a script in package.json that wraps the paragon serve-theme-css command

"serve-theme-css": "paragon serve-theme-css --theme-name 'Local Elm (edX.org)'",

Using the URLs from that command in a local env.config.js should do the trick

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Nice. I'll do that in a follow-up if that's cool.

Comment thread brand-sample/README.md Outdated

### ***OR*** manually add to a `frontend-base` site's `site.config.tsx`
Add the following block to your `SiteConfig` object in `site.config.tsx`
If you are running a frontend-base site, configure its `env.config.js` to install this theme:
Copy link
Copy Markdown
Contributor

@brian-smith-tcril brian-smith-tcril May 16, 2026

Choose a reason for hiding this comment

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

frontend-base doesn't use env.config.js. https://github.com/openedx/frontend-template-site and all the frontend-base branches of frontend-app-* repos include site.config.*.tsx files that already have SiteConfig objects, so not having a full example file here was intentional.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Right, typo on my part. Should be fixed now.

@kdmccormick kdmccormick force-pushed the kdmccormick/brand-readme branch from 25e52e7 to ea89d01 Compare May 17, 2026 00:51
@kdmccormick
Copy link
Copy Markdown
Member Author

@brian-smith-tcril any objections to me merging this one?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants