google-webfonts-helper

google-webfonts-helper is an open-source web application that allows users to download Google Fonts for self-hosting on private servers. It provides a way to obtain font files and the corresponding CSS snippets required to implement them without relying on external CDNs. This ensures that typography assets are served directly from the project's own infrastructure, providing more control over asset delivery.

The software is deployed as a server application and is available as a prebuilt Docker image. It can be run as a standalone service that provides a user interface for font selection and a public JSON API for programmatic access to font data and files. Users can interact with the tool via a browser or use the API to automate the retrieval of font assets for larger projects.

Key features

• Download font files in .eot, .woff, .woff2, .svg, and .ttf formats
• Generate CSS snippets for self-hosting fonts
• Customization of font styles and charsets
• Zipped archive downloads for specified font variants and formats
• Public JSON API for retrieving font lists and metadata
• Support for multiple font subsets including latin and cyrillic
• Docker-based deployment for easy server installation

The application is built using an Express server and a client side interface. It requires a Google Fonts API key for full functionality. The server side has been refactored with TypeScript and supports modern Node.js versions, including Node 22, and supports linux/arm64 architecture. While the server is modernized, the client side remains based on legacy Angular code. The JSON API allows for detailed queries, enabling users to filter by font ID, subsets, and specific variants to get exact URLs for the actual font files hosted on Google servers.

This tool is designed for frontend developers who need to manage their own typography assets to improve privacy, reduce external dependencies, or comply with strict hosting requirements. It serves as a utility for developers to migrate Google Fonts from a hosted service to a local server environment.