Home

Awesome


Setting up your font

New repositories

  1. Hit the green button above ("Use this template") to create your own repository.

  2. Clone the repository, and replace the font sources in the sources directory with your own font sources. These sources may be either in Glyphs format or UFO/Designspace formats.

    Unlike many open source distributors, Google Fonts is curated. Fonts shipped to the platform have to match the Google Fonts Specifications. Please read them carefully.

    (The sample font provided in this template is Radio Canada by Charles Daoud, Etienne Aubert Bonn, Alexandre Saumier Demers and contributors.)

  3. Then reference the sources in the file sources/config.yaml, as well as making any other changes you would like to make based on the instructions in the Google Fonts Builder documentation.

  4. Add yourself to the AUTHORS.txt and CONTRIBUTORS.txt files.

  5. Fill out documentation/DESCRIPTION.en_us.html with a description about your font.

  6. Rewrite this Readme file according to the recommendations in the Google Fonts Guide.

  7. Add and commit these files to git.

  8. At the command line, run make customize to ensure that all the paths and URLs in your project are correct. This will also push your changes to GitHub.

  9. Set up your GitHub pages site: go to Settings > Pages and ensure that the "Source" drop-down is set to "Deploy from a Branch". Ensure that the "Branch" is set to gh-pages. If this branch is not available, check that the "Build font and specimen" action in the "Actions" tab has completed; if it completed successfully, then try again - gh-pages should now be an option.

  10. If Github Actions has successfully built the family, you will find the font binaries in the Actions tab. The official Github Actions documentation provides further information.

Updating a repository

  1. To update your font repository to bring in the latest best-practices from the Google Fonts Project Template, run make update-project-template from the command line. This requires the node Javascript engine to be installed; if you don't have that already, follow these instructions to install on your platform.

  2. To update the Python build chain which builds your fonts, run make update and git add/git commit the new requirements.txt.

More things to do


My Font

Description of your font goes here. We recommend to start with a very short presentation line (the kind you would use on twitter to present your project for example), and then add as much details as necesary :-) Origin of the project, idea of usage, concept of creation… but also number of masters, axes, character sets, etc.

Don't hesitate to create images!

Sample Image Sample Image

About

Description of you and/or organisation goes here.

Building

Fonts are built automatically by GitHub Actions - take a look in the "Actions" tab for the latest build.

If you want to build fonts manually on your own computer:

The proof files and QA tests are also available automatically via GitHub Actions - look at https://yourname.github.io/your-font-repository-name.

Changelog

When you update your font (new version or new release), please report all notable changes here, with a date. Font Versioning is based on semver. Changelog example:

26 May 2021. Version 2.13

License

This Font Software is licensed under the SIL Open Font License, Version 1.1. This license is available with a FAQ at https://scripts.sil.org/OFL

Repository Layout

This font repository structure is inspired by Unified Font Repository v0.3, modified for the Google Fonts workflow.