Skip to content

Conversation

@its-miroma
Copy link
Member

@its-miroma its-miroma commented Jan 1, 2026

I'd appreciate feedback on font choices. I chose JetBrains Mono which afaik is used in IntelliJ. I did not embed the fonts directly, rather I used Google Fonts.

I also used Noto Color Emoji for flags, instead of tracking the woff2 file in the repo.


Do you wish the Docs had more personality in their font choice? Maybe a Serif, or something different for headings vs paragraphs?

Are any languages broken because the fonts we're using don't support their characters fully?

@its-miroma its-miroma added the needs-discussion Further discussion is needed label Jan 1, 2026
@its-miroma its-miroma requested a review from a team as a code owner January 1, 2026 22:42
@its-miroma its-miroma added the framework Related to the VitePress framework label Jan 1, 2026
@netlify
Copy link

netlify bot commented Jan 1, 2026

Deploy Preview for nimble-elf-d9d491 ready!

Name Link
🔨 Latest commit 5fb8209
🔍 Latest deploy log https://app.netlify.com/projects/nimble-elf-d9d491/deploys/6956f9218ffa97000834e2ce
😎 Deploy Preview https://deploy-preview-445--nimble-elf-d9d491.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

use JetBrains Mono and Noto Color Emoji from Google Fonts

use a hyphen for the lang attribute
@cassiancc
Copy link
Member

Font changes are pretty invisible to my eyes, even switching side by side, so no issues there for me. I definitely would not want serifs in the body, though I wouldn't be opposed to testing how it looks in a header. As long as there's fallback fonts, other language support shouldn't be an issue as far as I know.

font-display: swap;
}
/* Google Fonts: JetBrains Mono, Noto Color Emoji (Windows does not render flags) */
@import url("https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&family=Noto+Color+Emoji&display=swap");
Copy link
Member

Choose a reason for hiding this comment

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

Is it possible to not have any external CDN dependencies? Im not strongly against this, it just feels nicer not to have them.

Copy link
Member

Choose a reason for hiding this comment

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

I have just found: https://fontsource.org/docs/getting-started/introduction It has both these fonts in a way that we should be able to easily depend on via npm. This is much better than including them in the repo or pulling them from google.

Copy link
Member Author

Choose a reason for hiding this comment

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

Reading into it, Google Fonts doesn't seem to be reliable long-term, as breaking changes get introduced without opt-out.
see: google/fonts#1307

I'll take a look at fontsource

Copy link
Member Author

Choose a reason for hiding this comment

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

Reading into it, Google Fonts doesn't seem to be reliable long-term, as breaking changes get introduced without opt-out.
see: google/fonts#1307

I'll take a look at fontsource

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

Labels

framework Related to the VitePress framework needs-discussion Further discussion is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants