Emoji Favicon Webpack Plugin
Generates a favicon based on an emoji for your webapp
Installation
$ npm install --save-dev emoji-favicon-webpack-plugin
Usage
Add the plugin to your webpack config and pass your emoji of choice to it as an argument. A favicon will be generated and outputted with your bundle.
const EmojiFaviconPlugin = require('emoji-favicon-webpack-plugin');
const HtmlPlugin = require('html-webpack-plugin');
module.exports = {
plugins: [
new EmojiFaviconPlugin('🦑'),
new HtmlPlugin()
]
};
If you're using html-webpack-plugin, the HTML tags necessary to include your favicon will automatically be added to the <head>
of your document.
...
<link rel="shortcut icon" href="favicon.ico">
</head>
Options
By default, we use Twemoji for consistent results across all operating systems. If you would prefer to use your system's emoji font instead, specify the useSystem
option in the constructor. You can also choose which icon sizes
to include!
new EmojiFaviconPlugin({
emoji: '🍣',
useSystem: true,
sizes: [16]
})
MacOS has a pretty awesome and extensive library of emojis built into its Apple Color Emoji typeface, but other operating systems aren't so lucky. If you normally develop on a Mac, you will see different results when you build your app on a Linux or Windows machine.
In order to get consistent results between development and production, you should make sure that you use the same operating system for building in each environment. For example, if you're using Travis CI to build your app, you must specify osx
as your os
option in your build config. You can read more about using OS X in Travis here.
In the wild