@blorkfield/overlay-core 0.3.0 → 0.4.0

package/README.md

@@ -308,55 +308,77 @@ scene.onUpdate((data) => {
 
 ## Font Setup
 
-### PNG Based Fonts
+### Bundled Fonts
 
-Create a directory structure under `/public/fonts/`:
+The package includes three default fonts ready to use:
 
+| Font | Type | Characters |
+|------|------|------------|
+| `block` | PNG | A-Z, a-z, 0-9 (pixel/block style) |
+| `handwritten` | PNG | A-Z, 0-9 (handwritten style) |
+| `Roboto` | TTF | All characters |
+
+#### Vite Projects
+
+Add the plugin to serve bundled fonts automatically:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import { overlayFontsPlugin } from '@blorkfield/overlay-core/vite';
+
+export default defineConfig({
+  plugins: [overlayFontsPlugin()],
+});
 ```
-public/
-  fonts/
-    fonts.json
-    handwritten/
-      A.png
-      B.png
-      ...
-    block/
-      A.png
-      a.png
-      ...
+
+That's it. The fonts are now available at `/fonts/` in your app.
+
+#### Other Build Tools
+
+For non-Vite projects, the bundled fonts are located at:
 ```
+node_modules/@blorkfield/overlay-core/fonts/
+```
+
+Configure your build tool to serve this directory at `/fonts/`.
 
-The `fonts.json` manifest:
+### Adding Custom Fonts
+
+Custom fonts can be added alongside the bundled fonts. Create a `fonts.json` manifest that includes both:
 
 ```json
 {
   "fonts": [
-    {
-      "name": "handwritten",
-      "type": "png",
-      "characters": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
-    },
-    {
-      "name": "block",
-      "type": "png",
-      "characters": "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
-    }
+    { "name": "block", "type": "png", "characters": "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789" },
+    { "name": "handwritten", "type": "png", "characters": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" },
+    { "name": "Roboto", "type": "ttf", "characters": "*", "fontUrl": "/fonts/Roboto/static/Roboto-Regular.ttf" },
+    { "name": "my-custom-font", "type": "png", "characters": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" }
   ]
 }
 ```
 
-### TTF Fonts
+#### PNG Fonts
+
+Create a directory with individual character images:
+
+```
+my-custom-font/
+  A.png
+  B.png
+  ...
+```
+
+#### TTF Fonts
+
+Add the font file and reference it in the manifest:
 
 ```json
 {
-  "fonts": [
-    {
-      "name": "Roboto",
-      "type": "ttf",
-      "characters": "*",
-      "fontUrl": "/fonts/Roboto/static/Roboto-Regular.ttf"
-    }
-  ]
+  "name": "MyFont",
+  "type": "ttf",
+  "characters": "*",
+  "fontUrl": "/fonts/MyFont/MyFont-Regular.ttf"
 }
 ```
 

package/dist/vite-plugin.cjs

@@ -0,0 +1,78 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vite-plugin.ts
+var vite_plugin_exports = {};
+__export(vite_plugin_exports, {
+  default: () => vite_plugin_default,
+  overlayFontsPlugin: () => overlayFontsPlugin
+});
+module.exports = __toCommonJS(vite_plugin_exports);
+var import_node_url = require("url");
+var import_node_path = require("path");
+var import_meta = {};
+function overlayFontsPlugin() {
+  let fontsDir;
+  return {
+    name: "overlay-core-fonts",
+    configResolved() {
+      try {
+        const currentFile = (0, import_node_url.fileURLToPath)(import_meta.url);
+        const currentDir = (0, import_node_path.dirname)(currentFile);
+        fontsDir = (0, import_node_path.resolve)(currentDir, "..", "fonts");
+      } catch {
+        if (typeof __dirname !== "undefined") {
+          fontsDir = (0, import_node_path.resolve)(__dirname, "..", "fonts");
+        } else {
+          throw new Error("Unable to determine fonts path");
+        }
+      }
+    },
+    configureServer(server) {
+      return async () => {
+        const sirv = (await import("sirv")).default;
+        const serve = sirv(fontsDir, { dev: true, etag: true });
+        server.middlewares.use("/fonts", serve);
+      };
+    },
+    configurePreviewServer(server) {
+      return async () => {
+        const sirv = (await import("sirv")).default;
+        const serve = sirv(fontsDir, { etag: true });
+        server.middlewares.use("/fonts", serve);
+      };
+    }
+  };
+}
+var vite_plugin_default = overlayFontsPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  overlayFontsPlugin
+});
+//# sourceMappingURL=vite-plugin.cjs.map

package/dist/vite-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin.ts"],"sourcesContent":["import type { Plugin, ViteDevServer, PreviewServer } from 'vite';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, resolve } from 'node:path';\n\n/**\n * Vite plugin that serves bundled fonts from the package.\n * Add this to your vite.config.ts plugins array to automatically\n * serve the default fonts at /fonts/.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { overlayFontsPlugin } from '@blorkfield/overlay-core/vite';\n *\n * export default defineConfig({\n *   plugins: [overlayFontsPlugin()],\n * });\n * ```\n */\nexport function overlayFontsPlugin(): Plugin {\n  let fontsDir: string;\n\n  return {\n    name: 'overlay-core-fonts',\n\n    configResolved() {\n      // Determine the fonts directory path\n      try {\n        const currentFile = fileURLToPath(import.meta.url);\n        const currentDir = dirname(currentFile);\n        // From dist/vite-plugin.js, fonts are at ../fonts\n        fontsDir = resolve(currentDir, '..', 'fonts');\n      } catch {\n        // Fallback for CJS where __dirname is available\n        if (typeof __dirname !== 'undefined') {\n          fontsDir = resolve(__dirname, '..', 'fonts');\n        } else {\n          throw new Error('Unable to determine fonts path');\n        }\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Dynamically import sirv (it's a vite dependency)\n      return async () => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const sirv = (await import('sirv' as any)).default as (dir: string, opts?: Record<string, unknown>) => any;\n        const serve = sirv(fontsDir, { dev: true, etag: true });\n        server.middlewares.use('/fonts', serve);\n      };\n    },\n\n    configurePreviewServer(server: PreviewServer) {\n      return async () => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const sirv = (await import('sirv' as any)).default as (dir: string, opts?: Record<string, unknown>) => any;\n        const serve = sirv(fontsDir, { etag: true });\n        server.middlewares.use('/fonts', serve);\n      };\n    },\n  };\n}\n\nexport default overlayFontsPlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,sBAA8B;AAC9B,uBAAiC;AAFjC;AAmBO,SAAS,qBAA6B;AAC3C,MAAI;AAEJ,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,iBAAiB;AAEf,UAAI;AACF,cAAM,kBAAc,+BAAc,YAAY,GAAG;AACjD,cAAM,iBAAa,0BAAQ,WAAW;AAEtC,uBAAW,0BAAQ,YAAY,MAAM,OAAO;AAAA,MAC9C,QAAQ;AAEN,YAAI,OAAO,cAAc,aAAa;AACpC,yBAAW,0BAAQ,WAAW,MAAM,OAAO;AAAA,QAC7C,OAAO;AACL,gBAAM,IAAI,MAAM,gCAAgC;AAAA,QAClD;AAAA,MACF;AAAA,IACF;AAAA,IAEA,gBAAgB,QAAuB;AAErC,aAAO,YAAY;AAEjB,cAAM,QAAQ,MAAM,OAAO,MAAa,GAAG;AAC3C,cAAM,QAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,MAAM,KAAK,CAAC;AACtD,eAAO,YAAY,IAAI,UAAU,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,IAEA,uBAAuB,QAAuB;AAC5C,aAAO,YAAY;AAEjB,cAAM,QAAQ,MAAM,OAAO,MAAa,GAAG;AAC3C,cAAM,QAAQ,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3C,eAAO,YAAY,IAAI,UAAU,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,sBAAQ;","names":[]}

package/dist/vite-plugin.d.cts

@@ -0,0 +1,20 @@
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin that serves bundled fonts from the package.
+ * Add this to your vite.config.ts plugins array to automatically
+ * serve the default fonts at /fonts/.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { overlayFontsPlugin } from '@blorkfield/overlay-core/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [overlayFontsPlugin()],
+ * });
+ * ```
+ */
+declare function overlayFontsPlugin(): Plugin;
+
+export { overlayFontsPlugin as default, overlayFontsPlugin };

package/dist/vite-plugin.d.ts

@@ -0,0 +1,20 @@
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin that serves bundled fonts from the package.
+ * Add this to your vite.config.ts plugins array to automatically
+ * serve the default fonts at /fonts/.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { overlayFontsPlugin } from '@blorkfield/overlay-core/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [overlayFontsPlugin()],
+ * });
+ * ```
+ */
+declare function overlayFontsPlugin(): Plugin;
+
+export { overlayFontsPlugin as default, overlayFontsPlugin };

package/dist/vite-plugin.js

@@ -0,0 +1,42 @@
+// src/vite-plugin.ts
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+function overlayFontsPlugin() {
+  let fontsDir;
+  return {
+    name: "overlay-core-fonts",
+    configResolved() {
+      try {
+        const currentFile = fileURLToPath(import.meta.url);
+        const currentDir = dirname(currentFile);
+        fontsDir = resolve(currentDir, "..", "fonts");
+      } catch {
+        if (typeof __dirname !== "undefined") {
+          fontsDir = resolve(__dirname, "..", "fonts");
+        } else {
+          throw new Error("Unable to determine fonts path");
+        }
+      }
+    },
+    configureServer(server) {
+      return async () => {
+        const sirv = (await import("sirv")).default;
+        const serve = sirv(fontsDir, { dev: true, etag: true });
+        server.middlewares.use("/fonts", serve);
+      };
+    },
+    configurePreviewServer(server) {
+      return async () => {
+        const sirv = (await import("sirv")).default;
+        const serve = sirv(fontsDir, { etag: true });
+        server.middlewares.use("/fonts", serve);
+      };
+    }
+  };
+}
+var vite_plugin_default = overlayFontsPlugin;
+export {
+  vite_plugin_default as default,
+  overlayFontsPlugin
+};
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin.ts"],"sourcesContent":["import type { Plugin, ViteDevServer, PreviewServer } from 'vite';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, resolve } from 'node:path';\n\n/**\n * Vite plugin that serves bundled fonts from the package.\n * Add this to your vite.config.ts plugins array to automatically\n * serve the default fonts at /fonts/.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { overlayFontsPlugin } from '@blorkfield/overlay-core/vite';\n *\n * export default defineConfig({\n *   plugins: [overlayFontsPlugin()],\n * });\n * ```\n */\nexport function overlayFontsPlugin(): Plugin {\n  let fontsDir: string;\n\n  return {\n    name: 'overlay-core-fonts',\n\n    configResolved() {\n      // Determine the fonts directory path\n      try {\n        const currentFile = fileURLToPath(import.meta.url);\n        const currentDir = dirname(currentFile);\n        // From dist/vite-plugin.js, fonts are at ../fonts\n        fontsDir = resolve(currentDir, '..', 'fonts');\n      } catch {\n        // Fallback for CJS where __dirname is available\n        if (typeof __dirname !== 'undefined') {\n          fontsDir = resolve(__dirname, '..', 'fonts');\n        } else {\n          throw new Error('Unable to determine fonts path');\n        }\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Dynamically import sirv (it's a vite dependency)\n      return async () => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const sirv = (await import('sirv' as any)).default as (dir: string, opts?: Record<string, unknown>) => any;\n        const serve = sirv(fontsDir, { dev: true, etag: true });\n        server.middlewares.use('/fonts', serve);\n      };\n    },\n\n    configurePreviewServer(server: PreviewServer) {\n      return async () => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const sirv = (await import('sirv' as any)).default as (dir: string, opts?: Record<string, unknown>) => any;\n        const serve = sirv(fontsDir, { etag: true });\n        server.middlewares.use('/fonts', serve);\n      };\n    },\n  };\n}\n\nexport default overlayFontsPlugin;\n"],"mappings":";AACA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,eAAe;AAiB1B,SAAS,qBAA6B;AAC3C,MAAI;AAEJ,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,iBAAiB;AAEf,UAAI;AACF,cAAM,cAAc,cAAc,YAAY,GAAG;AACjD,cAAM,aAAa,QAAQ,WAAW;AAEtC,mBAAW,QAAQ,YAAY,MAAM,OAAO;AAAA,MAC9C,QAAQ;AAEN,YAAI,OAAO,cAAc,aAAa;AACpC,qBAAW,QAAQ,WAAW,MAAM,OAAO;AAAA,QAC7C,OAAO;AACL,gBAAM,IAAI,MAAM,gCAAgC;AAAA,QAClD;AAAA,MACF;AAAA,IACF;AAAA,IAEA,gBAAgB,QAAuB;AAErC,aAAO,YAAY;AAEjB,cAAM,QAAQ,MAAM,OAAO,MAAa,GAAG;AAC3C,cAAM,QAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,MAAM,KAAK,CAAC;AACtD,eAAO,YAAY,IAAI,UAAU,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,IAEA,uBAAuB,QAAuB;AAC5C,aAAO,YAAY;AAEjB,cAAM,QAAQ,MAAM,OAAO,MAAa,GAAG;AAC3C,cAAM,QAAQ,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3C,eAAO,YAAY,IAAI,UAAU,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,sBAAQ;","names":[]}

package/fonts/Roboto/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2011 The Roboto Project Authors (https://github.com/googlefonts/roboto-classic)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/fonts/Roboto/README.txt

@@ -0,0 +1,118 @@
+Roboto Variable Font
+====================
+
+This download contains Roboto as both variable fonts and static fonts.
+
+Roboto is a variable font with these axes:
+  wdth
+  wght
+
+This means all the styles are contained in these files:
+  Roboto-VariableFont_wdth,wght.ttf
+  Roboto-Italic-VariableFont_wdth,wght.ttf
+
+If your app fully supports variable fonts, you can now pick intermediate styles
+that aren’t available as static fonts. Not all apps support variable fonts, and
+in those cases you can use the static font files for Roboto:
+  static/Roboto_Condensed-Thin.ttf
+  static/Roboto_Condensed-ExtraLight.ttf
+  static/Roboto_Condensed-Light.ttf
+  static/Roboto_Condensed-Regular.ttf
+  static/Roboto_Condensed-Medium.ttf
+  static/Roboto_Condensed-SemiBold.ttf
+  static/Roboto_Condensed-Bold.ttf
+  static/Roboto_Condensed-ExtraBold.ttf
+  static/Roboto_Condensed-Black.ttf
+  static/Roboto_SemiCondensed-Thin.ttf
+  static/Roboto_SemiCondensed-ExtraLight.ttf
+  static/Roboto_SemiCondensed-Light.ttf
+  static/Roboto_SemiCondensed-Regular.ttf
+  static/Roboto_SemiCondensed-Medium.ttf
+  static/Roboto_SemiCondensed-SemiBold.ttf
+  static/Roboto_SemiCondensed-Bold.ttf
+  static/Roboto_SemiCondensed-ExtraBold.ttf
+  static/Roboto_SemiCondensed-Black.ttf
+  static/Roboto-Thin.ttf
+  static/Roboto-ExtraLight.ttf
+  static/Roboto-Light.ttf
+  static/Roboto-Regular.ttf
+  static/Roboto-Medium.ttf
+  static/Roboto-SemiBold.ttf
+  static/Roboto-Bold.ttf
+  static/Roboto-ExtraBold.ttf
+  static/Roboto-Black.ttf
+  static/Roboto_Condensed-ThinItalic.ttf
+  static/Roboto_Condensed-ExtraLightItalic.ttf
+  static/Roboto_Condensed-LightItalic.ttf
+  static/Roboto_Condensed-Italic.ttf
+  static/Roboto_Condensed-MediumItalic.ttf
+  static/Roboto_Condensed-SemiBoldItalic.ttf
+  static/Roboto_Condensed-BoldItalic.ttf
+  static/Roboto_Condensed-ExtraBoldItalic.ttf
+  static/Roboto_Condensed-BlackItalic.ttf
+  static/Roboto_SemiCondensed-ThinItalic.ttf
+  static/Roboto_SemiCondensed-ExtraLightItalic.ttf
+  static/Roboto_SemiCondensed-LightItalic.ttf
+  static/Roboto_SemiCondensed-Italic.ttf
+  static/Roboto_SemiCondensed-MediumItalic.ttf
+  static/Roboto_SemiCondensed-SemiBoldItalic.ttf
+  static/Roboto_SemiCondensed-BoldItalic.ttf
+  static/Roboto_SemiCondensed-ExtraBoldItalic.ttf
+  static/Roboto_SemiCondensed-BlackItalic.ttf
+  static/Roboto-ThinItalic.ttf
+  static/Roboto-ExtraLightItalic.ttf
+  static/Roboto-LightItalic.ttf
+  static/Roboto-Italic.ttf
+  static/Roboto-MediumItalic.ttf
+  static/Roboto-SemiBoldItalic.ttf
+  static/Roboto-BoldItalic.ttf
+  static/Roboto-ExtraBoldItalic.ttf
+  static/Roboto-BlackItalic.ttf
+
+Get started
+-----------
+
+1. Install the font files you want to use
+
+2. Use your app's font picker to view the font family and all the
+available styles
+
+Learn more about variable fonts
+-------------------------------
+
+  https://developers.google.com/web/fundamentals/design-and-ux/typography/variable-fonts
+  https://variablefonts.typenetwork.com
+  https://medium.com/variable-fonts
+
+In desktop apps
+
+  https://theblog.adobe.com/can-variable-fonts-illustrator-cc
+  https://helpx.adobe.com/nz/photoshop/using/fonts.html#variable_fonts
+
+Online
+
+  https://developers.google.com/fonts/docs/getting_started
+  https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Fonts/Variable_Fonts_Guide
+  https://developer.microsoft.com/en-us/microsoft-edge/testdrive/demos/variable-fonts
+
+Installing fonts
+
+  MacOS: https://support.apple.com/en-us/HT201749
+  Linux: https://www.google.com/search?q=how+to+install+a+font+on+gnu%2Blinux
+  Windows: https://support.microsoft.com/en-us/help/314960/how-to-install-or-remove-a-font-in-windows
+
+Android Apps
+
+  https://developers.google.com/fonts/docs/android
+  https://developer.android.com/guide/topics/ui/look-and-feel/downloadable-fonts
+
+License
+-------
+Please read the full license text (OFL.txt) to understand the permissions,
+restrictions and requirements for usage, redistribution, and modification.
+
+You can use them in your products & projects – print or digital,
+commercial or otherwise.
+
+This isn't legal advice, please consider consulting a lawyer and see the full
+license for all details.