An open API service indexing awesome lists of open source software.

https://github.com/fgnass/decap-cms-widget-iconify

Iconify Widget for Decap CMS
https://github.com/fgnass/decap-cms-widget-iconify

Last synced: 3 months ago
JSON representation

Iconify Widget for Decap CMS

Awesome Lists containing this project

README

          

# Iconify Widget for Decap CMS

A custom widget for [Decap CMS](https://decapcms.org/) (formerly Netlify CMS) that allows you to search and select icons from [Iconify](https://iconify.design/) collections.

## Features

- Search for icons from Iconify collections
- Preview selected icons
- Filter icons by collection or pattern
- Seamless integration with Decap CMS

Screenshot

## Installation

```bash
npm install decap-cms-widget-iconify
# or
yarn add decap-cms-widget-iconify
```

## Usage

```js
import CMS from 'decap-cms-app';
import { WidgetIconify } from 'decap-cms-widget-iconify';

// Register the widget
CMS.registerWidget(WidgetIconify.Widget());
```

### Configuration

You can configure the widget with the following options:

```js
CMS.registerWidget(
WidgetIconify.Widget({
// The Iconify collection to use (default: 'mdi')
collection: "material-symbols-light",

// Optional regex filter to limit icons
filter: /-outline-rounded$/,
})
);
```

### Field Configuration

Use the widget in your Decap CMS configuration:

```yaml
# In your config.yml
fields:
- label: 'Icon'
name: 'icon'
widget: 'icon'
```

## License

MIT