Skip to content

Style Scaladoc with consistent accent color (Typelevel red)#4813

Closed
afrdbaig7 wants to merge 1 commit intotypelevel:mainfrom
afrdbaig7:style/scaladoc-accent-color
Closed

Style Scaladoc with consistent accent color (Typelevel red)#4813
afrdbaig7 wants to merge 1 commit intotypelevel:mainfrom
afrdbaig7:style/scaladoc-accent-color

Conversation

@afrdbaig7
Copy link

Fixes #1835

This PR adds an optional external CSS hook for Cats Scaladoc so link and navigation colors can use a consistent accent color (Typelevel red by default).

The implementation uses Scaladoc’s supported -doc-external-css option and does not modify any generated documentation files. Styling is opt-in and non-blocking: if the CSS file is not present, documentation generation proceeds unchanged.

This is a purely cosmetic change affecting only generated Scaladoc output and has no impact on runtime behavior or library APIs.

@afrdbaig7 afrdbaig7 force-pushed the style/scaladoc-accent-color branch from da86492 to 58b6510 Compare January 26, 2026 09:34
Fixes typelevel#1835

Introduces an optional external stylesheet for Cats Scaladoc to apply consistent accent branding (Typelevel red) to links and navigation.

Changes:
- Adds project/scaladoc-style.css with scoped CSS variables
- Updates build.sbt to use post-processing to safely append styles (fixes missing flag in Scala 2.13)
- Ensures zero build impact if the CSS file is missing

This change is purely cosmetic and does not affect runtime behavior.
@afrdbaig7 afrdbaig7 force-pushed the style/scaladoc-accent-color branch from 58b6510 to 39c42f4 Compare January 26, 2026 10:00
@afrdbaig7 afrdbaig7 closed this Jan 26, 2026
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.

Style scaladoc slightly

1 participant