Skip to content

Font Awesome preset

@vuecs/icons-font-awesome populates vuecs's semantic-slot defaults with Font Awesome 6 Solid Iconify names (fa6-solid:*). Successor to the removed @vuecs/theme-font-awesome — same visuals, but driven through <VCIcon> (Iconify) instead of CSS-class injection.

bash
npm install @vuecs/icons-font-awesome

Setup

ts
import vuecs from '@vuecs/core';
import fontAwesome from '@vuecs/icons-font-awesome';

app.use(vuecs, {
    icons: [fontAwesome()],
});

The preset is config-only — no icon data ships with this package. Wire icon delivery via your existing tooling. See Icons setup → Delivery options for the full recipes.

What it configures

ComponentSlotIcon
VCPaginationfirstIconfa6-solid:angles-left
VCPaginationprevIconfa6-solid:chevron-left
VCPaginationnextIconfa6-solid:chevron-right
VCPaginationlastIconfa6-solid:angles-right
useSubmitButton()createIconfa6-solid:plus
useSubmitButton()updateIconfa6-solid:floppy-disk

Migrating from @vuecs/theme-font-awesome

The old package was a theme — it injected fa fa-* class strings into theme slots like pagination.prevIcon. Components rendered <i :class="theme.prevIcon">.

The new world is Iconify-backed: components render <VCIcon :name="defaults.prevIcon">, where defaults.prevIcon is an Iconify name string like 'fa6-solid:chevron-left'. The preset configures those defaults.

BeforeAfter
npm install @vuecs/theme-font-awesomenpm install @vuecs/icon @vuecs/icons-font-awesome
import fa from '@vuecs/theme-font-awesome'import fa from '@vuecs/icons-font-awesome'
themes: [bootstrap(), fa()]themes: [bootstrap()], icons: [fa()]
<i class="fa fa-plus"> (auto-rendered)<VCIcon name="fa6-solid:plus"> (auto-rendered)
Font Awesome stylesheet via CSSIconify icon delivery (see Icons setup)

See also

Released under the Apache 2.0 License.