feat: Change brand-sample from Purple to 'Autumn'

Also, make the readme steps copy-able

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: kdmccormick

brand-sample/README.md

@@ -1,6 +1,6 @@
 # brand-sample
 
-**This is a simple example brand package that changes the `brand` color to purple.**
+**This is a simple example brand package that changes the `brand` colors to an autumn-inspired palette.**
 
 ### Before
 ![Screenshot of the Authn MFE with this brand package enabled](./docs/images/authn-without-theme.png)
@@ -56,23 +56,43 @@ hooks.Filters.ENV_PATCHES.add_item(
 
 #### Using the [Tutor Paragon Plugin](https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon) (Recommended)
 
-1. [Install](https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon#installation) and [enable](https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon#enable-the-plugin) the Tutor Paragon Plugin (`tutor-contrib-paragon`)
-2. [Build](https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon#build-the-paragon-image) the `paragon-builder` image.
-2. Navigate to your Tutor config directory (you can find this by running `tutor config printroot`)
-3. From your config directory, navigate to `env/plugins/paragon` (the full path on my dev machine is `~/.local/share/tutor-main/env/plugins/paragon`)
-4. You should see some directories in there, find the `theme-sources` directory.
-5. Place this theme's [`color.json` file](./src/tokens/src/themes/light/global/color.json) in the appropriate subdirectory of the `theme-sources` directory.
-```sh
-$ tree ~/.local/share/tutor-main/env/plugins/paragon
-├── [...]
-└── theme-sources
-    └── themes
-        └── light
-            └── global
-                └── color.json
+Set up the Tutor Paragon plugin, which will reproducibly compile and serve brands for you:
+```bash
+# Install and enable the Tutor Paragon plugin.
+tutor plugins install https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon
+tutor plugins enable paragon
+
+# Build the paragon-builder image.
+# With this built, the `tutor local do paragon-build-tokens` command becomes available.
+tutor images build paragon-buidler
+
+# Ensure MFE containers is running if it isn't already.
+# The MFE image will serve the CSS that you compile with paragon-build-tokens.
+tutor dev start -d lms cms mfe
+```
+
+Every time you edit a theme, copy it into your tutor root and re-run paragon-build-tokens. Run this from the root of the sample-plugin repository:
+
+```bash
+tutor_root="$(tutor config printroot)"
+[ -n "$tutor_root" ] \
+  && rm -rf "$tutor_root/env/plugins/paragon/theme-sources/themes" \
+  && cp -r brand-sample/src/tokens/src/themes "$tutor_root/env/plugins/paragon/theme-sources" \
+  && tutor local do paragon-build-tokens
+  || echo 'Could not copy design token sources into tutor environment!' 
+```
+
+Note: If you are having issues building the tokens, check the contents of your tutor root:
+
+```bash
+tree "$(tutor config printroot)/env/plugins/paragon"
+ ├── [...]
+ └── theme-sources
+     └── themes
+         └── light
+             └── global
+                 └── color.json
 ```
-6. [Build](https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-paragon#build-all-themes) the theme
-7. Start `tutor`  (`tutor dev start lms cms mfe` or `tutor local start lms cms mfe`)
 
 ### ***OR*** manually add to an MFE's `env.config.js(x)`
 Minimal `env.config.js` to install this theme