Skip to content package
fontmin v2.0.0 Minify font seamlessly, font subsetter, webfont (eot, woff, svg) converter.
node >=16 19 deps esm cjs types open source
overview readme
license MIT
deps 19
unpacked 47.5 kB
files 18
node >=16 $ npm install fontmin@2.0.0n npmREADME GitHub-flavored package documentation.
downloads Across all versions.
Download trend unavailable.
compatibility Runtime metadata.
keywords Tagged topics.
font webfont icon iconfont font-face compress minify font-cli otf ttf woff woff2
install size Estimated unpacked size across 63 packages.
17.0 MB+
Includes dependencies.
dependencies 19 direct · 10 outdated
versions Latest published Aug 13, 2025
maintainers Registry package owners.
contents
fontmin
Minify font seamlessly
ecomfe-admin
ecomfe@gmail.com
Homepage
Install $ npm install --save fontmin copy
Usage import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. src ( 'fonts/*.ttf' )
. dest ( 'build/fonts' );
fontmin. run ( function (err, files) {
if (err) {
throw err;
}
console. log (files[ 0 ]);
// => { contents: <Buffer 00 01 00 ...> }
}); copy import Fontmin from 'fontmin' ;
const rename = require ( 'gulp-rename' );
const fontmin = new Fontmin ()
. src ( 'fonts/big.ttf' )
. use ( rename ( 'small.ttf' )); copy
API
new Fontmin() Creates a new Fontmin instance.
.src(file) Type: Array|Buffer|String
Set the files to be optimized. Takes a buffer, glob string or an array of glob strings
as argument.
.dest(folder) Set the destination folder to where your files will be written. If you don't set
any destination no files will be written.
.use(plugin) Add a plugin to the middleware stack.
.run(cb) Optimize your files with the given settings.
cb(err, files, stream) The callback will return an array of vinyl files in files and a Readable/Writable
stream in stream
Plugins The following plugins are bundled with fontmin:
glyph — Compress ttf by glyph.
ttf2eot — Convert ttf to eot.
ttf2woff — Convert ttf to woff.
ttf2woff2 — Convert ttf to woff2.
ttf2svg — Convert ttf to svg.
css — Generate css from ttf, often used to make iconfont.
svg2ttf — Convert font format svg to ttf.
svgs2ttf — Concat svg files to a ttf, just like css sprite.
otf2ttf — Convert otf to ttf.
.glyph() import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. glyph ({
text: '天地玄黄 宇宙洪荒' ,
hinting: false // keep ttf hint info (fpgm, prep, cvt). default = true
})); copy
.ttf2eot() import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. ttf2eot ()); copy
.ttf2woff() import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. ttf2woff ({
deflate: true // deflate woff. default = false
})); copy
.ttf2woff2() import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. ttf2woff2 ()); copy
.ttf2svg() import Fontmin from 'fontmin' ;
const svgo = require ( 'imagemin-svgo' );
const fontmin = new Fontmin ()
. use (Fontmin. ttf2svg ())
. use ( svgo ());
copy
.css() Generate css from ttf, often used to make iconfont.
import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. css ({
fontPath: './' , // location of font file
base64: true , // inject base64 data:application/x-font-ttf; (gzip font with css).
// default = false
glyph: true , // generate class for each glyph. default = false
iconPrefix: 'my-icon' , // class prefix, only work when glyph is `true`. default to "icon"
fontFamily: 'myfont' , // custom fontFamily, default to filename or get from analysed ttf file
asFileName: false , // rewrite fontFamily as filename force. default = false
local: true // boolean to add local font. default = false
})); copy Alternatively, a transform function can be passed as fontFamily option.
import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. use (Fontmin. css ({
// ...
fontFamily : function (fontInfo, ttf) {
return "Transformed Font Family Name"
},
// ...
})); copy
.svg2ttf() Convert font format svg to ttf.
import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. src ( 'font.svg' )
. use (Fontmin. svg2ttf ()); copy
.svgs2ttf() Concat svg files to a ttf, just like css sprite.
awesome work with css plugin:
import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. src ( 'svgs/*.svg' )
. use (Fontmin. svgs2ttf ( 'font.ttf' , {fontName: 'iconfont' }))
. use (Fontmin. css ({
glyph: true
})); copy
.otf2ttf() import Fontmin from 'fontmin' ;
const fontmin = new Fontmin ()
. src ( 'fonts/*.otf' )
. use (Fontmin. otf2ttf ()); copy
CLI $ npm install -g fontmin copy $ fontmin --help
Usage
$ fontmin < fil e > [<output>]
$ fontmin < director y > [<output>]
$ fontmin < fil e > > < outpu t >
$ cat < fil e > | fontmin > < outpu t >
Example
$ fontmin fonts/ * build
$ fontmin fonts build
$ fontmin foo.ttf > foo-optimized.ttf
$ cat foo.ttf | fontmin > foo-optimized.ttf
Options
-t, --text require glyphs by text
-b, --basic-text require glyphs with base chars
-d, --deflate-woff deflate woff
--font-family font-family for @font-face CSS
--css-glyph generate class for each glyf. default = false
-T, --show-time show time fontmin cost copy you can use curl to generate font for websites running on PHP, ASP, Rails and more:
$ text=` curl www.baidu.com` && fontmin -t " $text " font.ttf copy $ npm install -g html-to-text
$ text=` curl www.baidu.com | html-to-text ` && fontmin -t " $text " font.ttf copy what is more, you can use phantom-fetch-cli to generate font for SPA running JS template:
$ npm install -g phantom-fetch-cli
$ text=` phantom-fetch http://www.chinaw3c.org` && fontmin -t " $text " font.ttf copy
Thanks
License