Skip to content

Refactor navbar and layout SCSS, update examples#2489

Merged
chalin merged 1 commit intogoogle:mainfrom
chalin:chalin-m24-navbar-2026-0128
Jan 29, 2026
Merged

Refactor navbar and layout SCSS, update examples#2489
chalin merged 1 commit intogoogle:mainfrom
chalin:chalin-m24-navbar-2026-0128

Conversation

@chalin
Copy link
Copy Markdown
Collaborator

@chalin chalin commented Jan 29, 2026

  • Contributes to Docsy/User-guide "skin" styles should be factored out and/or dropped in some cases #1655 by restoring some Bootstrap default styles, and moving some extra (navbar) styling to assets/scss/td/_extra.scss. Allowing projects to opt-in to the extra styling.
  • Blog RSS button is now a btn-primary (was secondary)
  • Breaking change for td-boxes (which includes blocks/* shortcodes): the value of min-height argument is used to set the height of the hero image, when provided. The auto setting had no effect on min-height. This parameter value has been renamed to auto-from-top. The auto setting still has no effect on min-height, but top margin and top padding are adjusted so that the hero image is framed from the base of the navbar.
  • assets/scss/td/_color-adjustments-dark.scss: among other changes, the scope of SCSS variables has been fixed -- they used to be inside of an @if $enable-dark-mode block, and so could not be used.
  • Navbar styling has been improved: among other changes, the height and background color are now more easily customizable.
  • Breaking change: Docsy has reverted to the default Bootstrap SCSS variable values (false) for $enable-gradients and $enable-shadows.
  • Cleaned up and consolidated assets/scss/_navbar.scss, the docsy.dev site's navbar style adjustments.
  • Added mention of the Goldydocs repository's branch model, etc.

Preview: https://deploy-preview-2489--docsydocs.netlify.app/

@chalin chalin added this to the 0.14.0 milestone Jan 29, 2026
- Contributes to [google#1655] by restoring some Bootstrap default styles, and moving
  some extra (navbar)styling to `assets/scss/td/_extra.scss`. Allowing projects
  to opt-in to the extra styling.
- Blog RSS button is not a `btn-primary` (was secondary)
- Breaking change for td-boxes (which includes `blocks/*` shortcodes): the value
  of `min-height` argument is used to set the height of the hero image, when
  provided. The `auto` setting had no effect on `min-height`. This parameter
  value has been renamed to `auto-from-top`. The `auto` setting still has no
  effect on `min-height`, but top margin and top padding are adjusted so that
  the hero image is framed from the base of the navbar.
- `assets/scss/td/_color-adjustments-dark.scss`: among other changes, the scope
  of SCSS variables has been fixed -- they used to be inside of an
  `@if $enable-dark-mode` block, and so could not be used.
- Navbar styling has been improved: among other changes, the height and
  background color are now more easily customizable.
- Breaking change: Docsy has reverted to the default Bootstrap SCSS variable
  values (false) for `$enable-gradients` and `$enable-shadows`.
- Cleaned up and consolidated `assets/scss/_navbar.scss`, the docsy.dev site's
  navbar style adjustments.
- Added mention of the Goldydocs repository's branch model, etc.
@chalin chalin force-pushed the chalin-m24-navbar-2026-0128 branch from bce58c6 to f1e96b5 Compare January 29, 2026 00:59
@chalin chalin merged commit 7cc86a3 into google:main Jan 29, 2026
12 checks passed
@chalin chalin deleted the chalin-m24-navbar-2026-0128 branch January 29, 2026 01:10
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.

1 participant