/posts/add-new-fonts-using-astro
Add new font families to your Astro project
Learn how to add new custom fonts to any astro project step-by-step
Publication date: 2025-10-15
Updated: 2025-10-16

Search a font
You can find fonts on sites like Google Fonts, once you find it, you can download it. After that unzip the fonts if necessary and place them in the public folder of your project: project-folder/public
Remember that font files typically come in formats like .ttf, .woff, or .woff2. The .woff2 format is recommended for web use as it provides the best compression and performance.
Steps to add custom fonts
- Download the font and place it in your folder project.
- Create a .css for that file.
- Add a font name to the tailwindcss file.
- Call the css file into your main css file.
Creating the CSS file
Here’s an example of how to create a CSS file for your custom font:
@font-face {
font-family: 'MyCustomFont';
src: url('/fonts/MyCustomFont.woff2') format('woff2'),
url('/fonts/MyCustomFont.woff') format('woff');
font-weight: normal;
font-style: normal;
font-display: swap;
}
Using `font-display: swap` ensures text remains visible during font loading, improving perceived performance.
Adding to Tailwind CSS
To use your custom font with Tailwind CSS, add it to your tailwind.config.js
file:
module.exports = {
theme: {
extend: {
fontFamily: {
'custom': ['MyCustomFont', 'sans-serif'],
},
},
},
}
Make sure the font name in your Tailwind config matches exactly with the font-family name in your CSS file.