WEBFONT(1)

okay bestie, welcome to WEBFONT(1) — yeah that's the User Commands one, section 1, we're in the big leagues 💅

---

✨ NAME ✨

webfont — literally converts a set of SVG files into a webfont, in various formats. that's the whole thing. that's her job 🎀

---

🦋 DESCRIPTION 🦋

she's a generator of fonts from svg icons, okay? the whole pipeline, no cap:

• svg icons → svg font
• svg font → ttf
• ttf → eot
• ttf → woff
• ttf → woff2

Usage:

webfont [input] [options]

Input: file(s) or glob(s) 🫶

The way that an input argument gets wrapped in quotation marks and then it's passed to fast-glob for cross-platform glob support?? iconic.

Options:

• --config — Path to a specific configuration file (JSON, YAML, or CommonJS) or the name of a module in node_modules that points to one. If no --config argument is provided, webfont will search for configuration files in the following places, in this order:
  1. a webfont property in package.json
  2. a .webfontrc file (with or without filename extension: .json, .yaml, and .js are available)
  3. a webfont.config.js file exporting a JS object

The search will begin in the working directory and move up the directory tree until a configuration file is found. she's climbing, your honor 🧗‍♀️

• -u, --fontName — The font family name you want, default: "webfont". 💖
• -h, --help — Output usage information. the classic.
• -v, --version — Output the version number. (hi, 11.4.0, love u)
• -f, --formats — Only this formats generate. picky queen behavior, and we respect it 🔥
• -d, --dest — Destination for generated fonts.
• -m, --dest-create — Create destination directory if it does not exist. she manifests it into existence ✨
• -t, --template — Type of template ('css', 'scss', 'styl') or path to custom template.
• -s, --destTemplate — Destination for generated template. If not passed used dest argument value.
• -c, --templateClassName — Class name in css template.
• -p, --templateFontPath — Font path in css template.
• -n, --templateFontName — Font name in css template.
• --templateCacheString — Specify cache string in scss/css template.
• --no-sort — Keeps the files in the same order of entry. chronological, as the universe intended 🦋
• --no-ligatures — Prevents adding ligature unicode.
• --verbose — Tell me everything!.

🌸 For svgicons2svgfont 🌸

• --fontId — The font id you want, default as --fontName.
• --fontStyle — The font style you want.
• --fontWeight — The font weight you want.
• --fixedWidth — Creates a monospace font of the width of the largest input icon. thicc and consistent 🫶
• --centerHorizontally — Calculate the bounds of a glyph and center it horizontally. centered, balanced, main character energy 👑
• --normalize — Normalize icons by scaling them to the height of the highest icon.
• --fontHeight — The outputted font height [MAX(icons.height)].
• --round — Setup the SVG path rounding [10e12].
• --descent — The font descent [0].
• --ascent — The font ascent [height - descent].
• --startUnicode — The start unicode codepoint for files without prefix [0xEA01].
• --prependUnicode — Prefix files with their automatically allocated unicode codepoint.
• --metadata — Content of the metadata tag.
• --addHashInFontUrl — Generated font url will be : [webfont].[ext]?v=[hash]

---

💀 reminder bestie: this whole page is from webfont 11.4.0, dated April 2026, and it lives under WEBFONT(1) in User Commands. that's the source, that's the version, that's the date — periodt. go build ur font, you absolute icon 🌈🦋💜