Skip to content

A Budibase component plugin to display any icon in the Font Awesome library

Notifications You must be signed in to change notification settings

mp-strachan/bb-fontawesome

Repository files navigation

Budibase Font Awesome (Free/Pro)

Current Library Version: 6.4.2

A Budibase component plugin to display any icon in the Font Awesome library, in either Thin, Light, Regular, or Solid types.

Description

Find out more about Budibase.

To view the full Font Awesome library:

Free Icon Library

The Font Awesome free library includes some regular icons (eg: clipboard), however, some are only included in the pro plan. If your icon doesn't display with the regular style selected, try using solid, then double-check the Font Awesome catalog.

How To Use

  1. Import the plugin into your budibase instance (see Budibase documentation for more info)

  2. Add the Font Awesome component to your application

  3. Find your desired icon from the Font Awesome library

  4. Copy the icon name by clicking on the icon header

  1. Paste the name of the icon into the icon field in your component settings

  1. You can configure other settings such as pulse or spin animation (good for loaders or progress indication), colour, and scale.

Note: Not all icons are available in the free library!

Font Awesome Pro

This plugin can also be built with support for the full Font Awesome Pro library, using your own Font Awesome Pro license. Learn more about Font Awesome Pro.

Building Font Awesome Pro

  1. Clone the repository

  2. Update the .npmrc file in the root of the plugin directory.

    • NOTE: See this link for how to configure your .npmrc file
  3. Open package.json and remove the following dependencies:

    • "@fortawesome/free-solid-svg-icons": "^6.2.1"
    • "@fortawesome/free-regular-svg-icons": "^6.2.1"
    • "@fortawesome/free-brands-svg-icons": "^6.4.2"
  4. Add the following dependencies

    • "@fortawesome/free-brands-svg-icons": "^6.4.2"
    • "@fortawesome/pro-light-svg-icons": "^6.4.2"
    • "@fortawesome/pro-regular-svg-icons": "^6.4.2"
    • "@fortawesome/pro-solid-svg-icons": "^6.4.2"
    • "@fortawesome/pro-thin-svg-icons": "^6.4.2"

Note: Ensure you use the latest/specific version of the dependencies in the above codeblocks

  1. Update dependencies by running npm install

  2. In schema.json, change the following line

    • "options": ["Solid", "Regular", "Brands"], => "options": ["Solid", "Regular", "Brands", "Light", "Thin"],
  3. In src/Component.svelte:

    • Comment out the free dependencies and uncomment the pro dependencies
    • Uncomment the Light and Thin styles in the IconStyle switch statement (around line 35)
  4. (Optional) Change the version number in package.json have pro, rather than free.

  5. Build the plugin: budi plugins --build

Local build instructions

To build your new plugin run the following in your Budibase CLI:

budi plugins --build

About

A Budibase component plugin to display any icon in the Font Awesome library

Resources

Stars

Watchers

Forks

Packages

No packages published