feat: Dynamic theming (#1358)

Co-authored-by: Carson Sievert <cpsievert1@gmail.com>
Co-authored-by: Carson Sievert <carson@posit.co>

Author: gadenbuie

.gitignore

@@ -8,19 +8,19 @@
 
 # Distribution / packaging
 .Python
-env/
-build/
-develop-eggs/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-dist/
+/env/
+/build/
+/develop-eggs/
+/downloads/
+/eggs/
+/.eggs/
+/lib/
+/lib64/
+/parts/
+/sdist/
+/var/
+/wheels/
+/dist/
 *.egg-info/
 .installed.cfg
 *.egg

CHANGELOG.md

@@ -39,6 +39,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Relative imports, like `from . import utils`, now can be used in Shiny Express apps. (#1464)
 
+* `ui.Theme` allows you to create custom themes for your Shiny app by recompiling [Bootstrap](https://getbootstrap.com/) and Shiny's Sass files with your own customizations. Themes created with `ui.Theme` can be passed directly to the `theme` argument of `express.ui.page_opts()` (Shiny Express) or `ui.page_*()` functions (Shiny Core) to apply the theme to the entire app. This feature requires the [libsass package](https://sass.github.io/libsass-python/) which can be installed with `pip install libsass`. (#1358)
+
 ### Bug fixes
 
 * Fixed #1440: When a Shiny Express app with a `www/` subdirectory was deployed to shinyapps.io or a Connect server, it would not start correctly. (#1442)

Makefile

@@ -207,3 +207,10 @@ install-deps: FORCE ## install dependencies
 # ## If caching is ever used, we could run:
 # install-deps: FORCE ## install latest dependencies
 # 	pip install --editable ".[dev,test]" --upgrade --upgrade-strategy eager
+
+upgrade-html-deps: FORCE ## Upgrade Shiny's HTMLDependencies
+	@if ! Rscript -e "q()"; then \
+	  echo "Error: Upgrading HTML dependencies requires R, but R is not installed or not in your PATH. Please install R and try again."; \
+	  exit 1; \
+	fi
+	@scripts/htmlDependencies.R

docs/_quartodoc-core.yml

@@ -99,6 +99,7 @@ quartodoc:
     - title: Custom UI
       desc: Lower-level UI functions for creating custom HTML/CSS/JS
       contents:
+        - ui.Theme
         - ui.HTML       # uses justattributes.rst template
         - ui.TagList    # uses class.rst template
         - name: ui.tags       # uses tags.rst template

docs/_quartodoc-express.yml

@@ -162,6 +162,7 @@ quartodoc:
     - title: UI as HTML
       desc: Tools for creating HTML/CSS/JS
       contents:
+        - express.ui.Theme
         - express.ui.markdown
         - express.ui.include_css
         - express.ui.include_js