Skip to content

feat: Replace ProximaNova with Figtree font family#2844

Merged
mateusz-zaboj merged 2 commits intomasterfrom
mz/proxima-replace-to-figtree
Oct 29, 2025
Merged

feat: Replace ProximaNova with Figtree font family#2844
mateusz-zaboj merged 2 commits intomasterfrom
mz/proxima-replace-to-figtree

Conversation

@mateusz-zaboj
Copy link
Copy Markdown
Contributor

@mateusz-zaboj mateusz-zaboj commented Oct 29, 2025

🎨 Overview

This PR replaces the ProximaNova font family with Figtree across the entire Brainly Style Guide design system.

📋 Changes Made

Font Assets

  • ✅ Added Figtree-*.woff* files with accordingly as it was done with ProximaNova
  • ✅ Updated both .storybook/public/fonts/ and src/fonts/ directories
  • ✅ Added Figtree Regular, Bold, and Black variants
  • ✅ ProximaNova was not removed from the repository, to allow being hosted for older versions of SG

Code Changes

  • SCSS: Updated $fontFamilyProximaNova variable in src/sass/_config.scss
  • Fonts: Modified @font-face declarations in src/sass/_fonts.scss
  • CSS: Updated font stack in src/css/config/fontFamily.js

Compatibility

  • ✅ Preserved existing CSS classes and styling hooks
  • ✅ No breaking changes to JavaScript/TypeScript interfaces

🔍 Testing Instructions

# Install dependencies
yarn install

# Build the project
yarn build

# Start Storybook to verify font rendering
yarn storybook

# Run tests to ensure no regressions
yarn test

Visual Verification:

  • Check all text components render with Figtree font
  • Verify font weights (Regular 400, Bold 700, Black 900) display correctly

🎯 Impact

  • Visual Change: All text in the design system will use Figtree instead of ProximaNova
  • Performance: Figtree has similar file sizes and web font performance

✅ Checklist

  • Font files properly converted to WOFF/WOFF2 format
  • SCSS variables updated correctly
  • CSS configuration modified
  • Build process completes without errors
  • Storybook renders with new font
  • All tests pass

Demo with live comparison Proxima and Figtree change (enable voice):

Proxima_to_Figtree_comparison.mov

@mateusz-zaboj mateusz-zaboj added the Change: Visual Marking release change containing visual changes e.g colors or size label Oct 29, 2025
@mateusz-zaboj mateusz-zaboj self-assigned this Oct 29, 2025
Comment on lines -128 to -130
.sg-button__text {
top: 1px;
}
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I checked that after font change and now with Figtree we don't need additional top: 1px.


The Brainly brand typeface is Proxima Nova, a geometric sans serif that works equally well with large headlines and functional copy. Use this typeface according to the following rules for consistency across the brand.

Proxima Nova combines modern proportions with a geometric appearance and has become one of the most popular web fonts, in use on thousands of websites around the world.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I decided to remove that paragraph since it's not relevant for now.

@mateusz-zaboj
Copy link
Copy Markdown
Contributor Author

With @matzimowski we decided to not remove ProximaNova assets in that PR. In the first place, we want to replace Proxima usage in our codebase and then as the last step we will remove ProximaNova assets from brainly-style-guide.

@mateusz-zaboj mateusz-zaboj marked this pull request as ready for review October 29, 2025 14:14
@mateusz-zaboj mateusz-zaboj merged commit 41be1a2 into master Oct 29, 2025
5 checks passed
@mateusz-zaboj mateusz-zaboj deleted the mz/proxima-replace-to-figtree branch October 29, 2025 14:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Change: Visual Marking release change containing visual changes e.g colors or size

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants