React Native Vector Icons - IcoMoon

React Native Vector Icons font package to support IcoMoon fonts

See the React Native Vector Icons README for more details.

Installation

npm install @react-native-vector-icons/icomoon

Usage

1. Add the config.json somewhere in your project to be imported
2. Add the ttf file into rnvi-fonts/icomoon. You can customise this location as described in react-native-vector-icons
3. Create the component in your project and use it

import createIconSet from '@react-native-vector-icons/icomoon';
import icoMoonConfig from './IcoMoon-Free.json';
const Icon = createIconSet(icoMoonConfig);

const icon = <Icon name="comments" />;

If you want to customise the font postscript name and filename you can pass extra arguments.

import createIconSet from "@react-native-vector-icons/icomoon";
import icoMoonConfig from "./IcoMoon-Free.json";
const Icon = createIconSet(icoMoonConfig, "Font Family", "FontFamily.ttf");

Type-checked icon names

You can pass a union of icon names as a generic parameter to get type-checking and autocomplete on the name prop:

import createIconSet from '@react-native-vector-icons/icomoon';
import icoMoonConfig from './IcoMoon-Free.json';
const Icon = createIconSet<'home' | 'settings' | 'user'>(icoMoonConfig);

<Icon name="home" />     // ok
<Icon name="invalid" />  // type error

Expo Config Plugin

This package ships an Expo config plugin to register the font with iOS. Add it to the plugins array in your app.json or app.config.js:

{
  "expo": {
    "plugins": ["@react-native-vector-icons/icomoon"]
  }
}

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT