{"id":27004328,"url":"https://github.com/fontist/setup-fontist","last_synced_at":"2025-09-01T18:38:54.439Z","repository":{"id":219010520,"uuid":"747930923","full_name":"fontist/setup-fontist","owner":"fontist","description":"🔠 Install Fontist for GitHub Actions","archived":false,"fork":false,"pushed_at":"2024-02-10T19:03:53.000Z","size":723,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-02-11T18:48:56.892Z","etag":null,"topics":["action","fontist","fonts","github-action","github-actions","google-fonts","installer","ruby","setup-action","setup-actions"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fontist.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-01-24T23:18:53.000Z","updated_at":"2024-02-11T18:48:56.892Z","dependencies_parsed_at":"2024-02-10T18:41:49.778Z","dependency_job_id":null,"html_url":"https://github.com/fontist/setup-fontist","commit_stats":null,"previous_names":["jcbhmr/setup-fontist","fontist/setup"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fontist%2Fsetup-fontist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fontist%2Fsetup-fontist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fontist%2Fsetup-fontist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fontist%2Fsetup-fontist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fontist","download_url":"https://codeload.github.com/fontist/setup-fontist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128740,"owners_count":20888235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["action","fontist","fonts","github-action","github-actions","google-fonts","installer","ruby","setup-action","setup-actions"],"created_at":"2025-04-04T06:16:06.985Z","updated_at":"2025-04-04T06:16:07.556Z","avatar_url":"https://github.com/fontist.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Setup Fontist\n\n🔠 Install [Fontist](https://www.fontist.org/) for GitHub Actions\n\n\u003ctable align=center\u003e\u003ctd\u003e\n\n```yml\n- uses: fontist/setup-fontist@v2\n- run: fontist install \"Fira Code\"\n```\n\n\u003c/table\u003e\n\n💎 Uses Ruby to install the fontist Ruby gem \\\n🟦 Works with Windows \\\n🐧 Works with Ubuntu \\\n🍎 Works with macOS \\\n⚡ Caches installation in `$RUNNER_TOOL_CACHE` and/ior the workflow cache \\\n📐 Caches `~/.fontist` font installs by default using `manifest.yml`\n\n## Usage\n\n![GitHub Actions](https://img.shields.io/static/v1?style=for-the-badge\u0026message=GitHub+Actions\u0026color=2088FF\u0026logo=GitHub+Actions\u0026logoColor=FFFFFF\u0026label=)\n![GitHub](https://img.shields.io/static/v1?style=for-the-badge\u0026message=GitHub\u0026color=181717\u0026logo=GitHub\u0026logoColor=FFFFFF\u0026label=)\n\n**🚀 Here's what you're after:**\n\n```yml\non: push\njobs:\n  job:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: fontist/setup-fontist@v2\n      - run: fontist install \"Fira Code\"\n```\n\n💡 You can use `fontist manifest-install manifest.yml` to install fonts listed in a manifest file similar to `package.json`, `requirements.txt`, and `Cargo.toml`.\n\n### Inputs\n\n- **`fontist-version`:** The version of Fontist to install. This can be an exact version lile `1.10.0` or a semver range such as `1.x` or `~1.15.0`. The default value is `latest`.\n\n- **`fontist-token`:** The GitHub token to use when fetching the version list from fontist/fontist. You shouldn't have to touch this. The default is the `github.token` if you're on github.com or unauthenticated (rate limited) if you're not on github.com.\n\n- **`cache`:** Whether or not to use [@actions/cache](https://www.npmjs.com/package/@actions/cache) to cache things in the GitHub workflow cache. This is enabled by default.\n\n- **`cache-dependency-path`:** A multiline list of globs to use to derive the `~/.fontist` cache key. The default is `manifest.yml` and `manifest.yaml`. If no files are matched at runtime then the `~/.fontist` folder will not be cached.\n\n### Outputs\n\n- **`fontist-version`:** The version of Fontist that was installed. This will be something like `1.10.0` or similar.\n\n- **`cache-hit`:** Whether or not Fontist was restored from the runner's cache or newly downloaded.\n\n## Development\n\n![Bun](https://img.shields.io/static/v1?style=for-the-badge\u0026message=Bun\u0026color=000000\u0026logo=Bun\u0026logoColor=FFFFFF\u0026label=)\n![Node.js](https://img.shields.io/static/v1?style=for-the-badge\u0026message=Node.js\u0026color=339933\u0026logo=Node.js\u0026logoColor=FFFFFF\u0026label=)\n![Ruby](https://img.shields.io/static/v1?style=for-the-badge\u0026message=Ruby\u0026color=CC342D\u0026logo=Ruby\u0026logoColor=FFFFFF\u0026label=)\n\nThis action tries to restore the result of `gem install fontist` from both the `$RUNNER_TOOL_CACHE` as well as the workflow cache via [@actions/cache](https://www.npmjs.com/package/@actions/cache). It then tries to restore the `~/.fontist` folder local cache from the workflow cache.\n\n**How do I test it?** \\\nOpen a PR (even a draft one works) and some magic GitHub Actions will run to test your changes.\n\nNote that since [Bun doesn't support Windows yet](https://github.com/oven-sh/bun/issues/43) we can't run the `bun build` command on Windows runners. Don't worry! The action should still work ok since Bun is only used for the build step; it runs using `node \u003cthe-js-file\u003e` via `using: node20` in both testing and releases. Once Bun adds Windows support remember to add back the Windows tests. 😉\n\n## Contributions\n\nThis GitHub Action was originally created by @jcbhmr for the\n[Typst project](https://github.com/typst-community/typst.js)\nand contributed to [Fontist](https://www.fontist.org).\n\nHuge thanks to @jcbhmr for the tremendous effort in improving the Fontist\necosystem!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffontist%2Fsetup-fontist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffontist%2Fsetup-fontist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffontist%2Fsetup-fontist/lists"}