fof/ui-kit

Frontend utilities for Flarum extension developers.

Maintainers

Package info

github.com/FriendsOfFlarum/ui-kit

Homepage

Language:TypeScript

pkg:composer/fof/ui-kit

Fund package maintenance!

Website

Statistics

Installs: 90

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-03-18 21:01 UTC

This package is auto-updated.

Last update: 2026-03-18 21:07:17 UTC


README

latest version mit license downloads

Flarum UiKit with reusable frontend utilities for extension developers. (Not An Extension)

Usage

Use the package's extender to register its resources.

extend.php

return [
    new FoF\UiKit\Extend\Register,
];

example.js

import ProgressBar from 'flarum/ui-kit/common/ProgressBar';
import Label from 'flarum/ui-kit/common/Label';
import LabelGroup from 'flarum/ui-kit/common/LabelGroup';
import Input from 'flarum/ui-kit/common/Input';

import DiscussionSearch from 'flarum/ui-kit/forum/DiscussionSearch';

/**
 * @param mini bool           small sized
 * @param alternate bool      works with backgrounds using control-bg background color
 * @param progress number     percentage
 * @param className string
 */
<ProgressBar fancy={true} mini={false} alternate={false} progress={93} />

/**
 * @param color string
 */
<Label color="red">Text</Label>

/**
 * Container for a group of labels
 */
<LabelGroup></LabelGroup>

/**
 * @param icon string         fontawesome icon
 * @param className string
 * ...attrs:    other attributes
 */
<Input icon="fas fa-user" className="Input--example"/>

/**
 * @param state GlobalSearchState
 * @param ignore number
 * @param onSelect (discussion: Discussion) => void
 */
<DiscussionSearch state={} ignore={485} onSelect={(discussion) => ...} />

Installation

$ composer require fof/ui-kit

Updating

$ composer update fof/ui-kit

Links

License

The MIT License.