If you read this before you have created your project Github repo, you would like to use the Google Fonts project template repo to start with everything set up for you.
The template is based on Raphael Bastide’s UFR and was adapted to meet Google Fonts’ needs. Its purpose is to help type designers set up their repo of open-source fonts — especially if they want to publish them on Google Fonts. A unified structure throughout all the repositories helps GF automate the fonts’ quality assurance and onboarding processes in the catalog.
But there is more: the project template incorporates GitHub Actions to provide users with many automation.
This is particularly practical if you don’t want to run gftools by yourself: your GitHub repo is doing it for you! The downside is that it is harder to customize for GitHub beginners or people who don’t want to get their hands dirty in some code, and so it may be harder to use for a project that doesn’t follow this exact template.
But give it a try :) Simon Cozens has made a 1 minute video to show how quick this way to start is.
Be aware that the scripts and automated actions provided by the Google Fonts project template are not mandatory, although your font repo still must follow certain requirements.
Texturina is a good example of a simple repo that only contains the essentials.
├── AUTHORS.txt
├── CONTRIBUTORS.txt
├── OFL.txt
├── README.md
├── documentation
│ ├── readme-images.jpg
│ └── promo.zip
├── fonts
│ ├── otf
│ │ └── FontFamily-Regular.otf
│ ├── ttf
│ │ └── FontFamily-Regular.ttf
│ ├── webfonts
│ │ └── FontFamily-Regular.woff2
│ └── variable
│ └── FontFamily-[wdth,wght].ttf
├── sources
│ ├── FontFamily.ext
│ ├── FontFamily-Italic.ext
│ └── config.yaml and/or build.sh
├── requirements.txt
└── .gitignore
Each file or dir has the following purpose:
An example is provided for each file (from this Guide or other repositories). Please use these templates and modify what you need.
AUTHORS.txt
Includes contact information for the project’s authors. Contributors must not be included in this file.
CONTRIBUTORS.txt
Includes contact information for the project’s contributors.
OFL.txt
The OFL license file. The first line of the license file must contain the font family’s copyright string.
README.md
Contains information about the font family and instructions on how to build the family. You should take particular care of this file, and you must add at least one image and a short description of your font project.
article subdirectory with the images to be included in the About section.social-assets subdirectory with the promotional assets for the social media platforms.image-license.txt file detailing the license for these images.sources
A directory containing the design source files and scripts used to build the fonts. Sources must not be kept in another directory.
There must be either a config.yaml or build.sh file that allows the fonts to be built in one command. For more context, you can read about the Scalable font production principle.
config.yaml
A configuration file that includes all the relevant project information for the Builder to build the font files.
build.sh
A Bash script to build the fonts in one command if the build process requires more than the single config.yaml file to build the font families of this repo.
fonts
A directory containing font binaries or subdirectories for each font format. If your project provides multiple formats, do not include them all in one folder. Create a folder for each format e.g fonts/otf, fonts/ttf, fonts/webfonts. The Builder told does that by default.
requirements.txt
File listing the Python packages (and their version if necessary) used for a project so that any user can easily install the necessary packages and replicate the production process.
.gitignore
File specifying untracked files that Git should ignore. Since the tools should be installed under a virtual environment dedicated to this repository, the .gitignore should include the env (or the name of your virtual environment you are using, for example, venv or env). Indeed, it is better not to push your virtual environment to Github and keep it local. You can add .DS_Store to the list of untracked files to keep collaboration between Mac and Windows users. If you use .glyphs sources, *(Autosave)* is also a relevant addition.
The files and directories listed above are mandatory. However, we don’t mind if you include further docs and dirs, but they should have a clear purpose (such as a scripts directory, for example).