Quick Setup via .env

The fastest way to configure Beartropy UI is through environment variables. No config publishing needed.

All available environment variables

 1# Prefix
 2BEARTROPY_UI_PREFIX=bt
 3 
 4# Icons
 5BEARTROPY_UI_ICON_SET=heroicons
 6BEARTROPY_UI_ICON_VARIANT=outline
 7 
 8# Component defaults (color and size)
 9BEARTROPY_UI_INPUT_COLOR=primary
10BEARTROPY_UI_INPUT_SIZE=md
11BEARTROPY_UI_INPUT_OUTLINE=true
12BEARTROPY_UI_TEXTAREA_COLOR=primary
13BEARTROPY_UI_TEXTAREA_SIZE=md
14BEARTROPY_UI_TEXTAREA_OUTLINE=true
15BEARTROPY_UI_BUTTON_COLOR=beartropy
16BEARTROPY_UI_BUTTON_SIZE=md
17BEARTROPY_UI_BADGE_COLOR=beartropy
18BEARTROPY_UI_BADGE_SIZE=sm
19BEARTROPY_UI_CHECKBOX_COLOR=beartropy
20BEARTROPY_UI_CHECKBOX_SIZE=md
21BEARTROPY_UI_RADIO_COLOR=beartropy
22BEARTROPY_UI_RADIO_SIZE=md
23BEARTROPY_UI_TOGGLE_COLOR=beartropy
24BEARTROPY_UI_TOGGLE_SIZE=md
25BEARTROPY_UI_TABLE_COLOR=beartropy
26BEARTROPY_UI_SELECT_COLOR=primary
27BEARTROPY_UI_SELECT_SIZE=md
28BEARTROPY_UI_CHAT_INPUT_COLOR=primary
29BEARTROPY_UI_LOOKUP_COLOR=beartropy
30BEARTROPY_UI_FILE_DROPZONE_COLOR=beartropy
31BEARTROPY_UI_TIME_PICKER_COLOR=beartropy
32BEARTROPY_UI_DATETIME_COLOR=beartropy

No publishing required

Environment variables work out of the box. You only need to publish the config file if you want to modify the preset loading order or add custom admin roles.

Publishing the Config File

Publish command

For advanced customization, publish the config file to config/beartropy/ui/beartropy.php:

1php artisan vendor:publish --provider="Beartropy\Ui\BeartropyUiServiceProvider" --tag="beartropy-ui-config"

Component Prefix

Set a prefix for all Beartropy UI Blade components to avoid naming conflicts.

config/beartropy/ui/beartropy.php

With 'prefix' => 'bt', components register as <x-bt-button>, <x-bt-alert>, etc. Leave empty to use <x-button>, <x-alert>.

1'prefix' => env('BEARTROPY_UI_PREFIX', 'bt'),

Icon Configuration

Choose the default icon set and variant used across all components.

config/beartropy/ui/beartropy.php

Supported sets: heroicons (default, included), lucide, fontawesome, and beartropy (built-in SVGs). You can override per-icon using the set prop.

1'icons' => [
2    'set' => env('BEARTROPY_UI_ICON_SET', 'heroicons'),
3    'variant' => env('BEARTROPY_UI_ICON_VARIANT', 'outline'), // outline | solid
4],

Component Defaults

Set global default colors and sizes for components. Individual component props always take precedence.

config/beartropy/ui/beartropy.php

 1'component_defaults' => [
 2    'input' => [
 3        'color' => env('BEARTROPY_UI_INPUT_COLOR', 'primary'),
 4        'size' => env('BEARTROPY_UI_INPUT_SIZE', 'md'),
 5        'outline' => env('BEARTROPY_UI_INPUT_OUTLINE', true),
 6    ],
 7    'textarea' => [
 8        'color' => env('BEARTROPY_UI_TEXTAREA_COLOR', 'primary'),
 9        'size' => env('BEARTROPY_UI_TEXTAREA_SIZE', 'md'),
10        'outline' => env('BEARTROPY_UI_TEXTAREA_OUTLINE', true),
11    ],
12    'button' => [
13        'color' => env('BEARTROPY_UI_BUTTON_COLOR', 'beartropy'),
14        'size' => env('BEARTROPY_UI_BUTTON_SIZE', 'md'),
15    ],
16    'badge' => [
17        'color' => env('BEARTROPY_UI_BADGE_COLOR', 'beartropy'),
18        'size' => env('BEARTROPY_UI_BADGE_SIZE', 'sm'),
19    ],
20    'checkbox' => [
21        'color' => env('BEARTROPY_UI_CHECKBOX_COLOR', 'beartropy'),
22        'size' => env('BEARTROPY_UI_CHECKBOX_SIZE', 'md'),
23    ],
24    'radio' => [
25        'color' => env('BEARTROPY_UI_RADIO_COLOR', 'beartropy'),
26        'size' => env('BEARTROPY_UI_RADIO_SIZE', 'md'),
27    ],
28    'toggle' => [
29        'color' => env('BEARTROPY_UI_TOGGLE_COLOR', 'beartropy'),
30        'size' => env('BEARTROPY_UI_TOGGLE_SIZE', 'md'),
31    ],
32    'select' => [
33        'color' => env('BEARTROPY_UI_SELECT_COLOR', 'primary'),
34        'size' => env('BEARTROPY_UI_SELECT_SIZE', 'md'),
35    ],
36    'table' => [
37        'color' => env('BEARTROPY_UI_TABLE_COLOR', 'beartropy'),
38    ],
39    'chat-input' => [
40        'color' => env('BEARTROPY_UI_CHAT_INPUT_COLOR', 'primary'),
41    ],
42    'lookup' => [
43        'color' => env('BEARTROPY_UI_LOOKUP_COLOR', 'beartropy'),
44    ],
45    'file-dropzone' => [
46        'color' => env('BEARTROPY_UI_FILE_DROPZONE_COLOR', 'beartropy'),
47    ],
48    'time-picker' => [
49        'color' => env('BEARTROPY_UI_TIME_PICKER_COLOR', 'beartropy'),
50    ],
51    'datetime' => [
52        'color' => env('BEARTROPY_UI_DATETIME_COLOR', 'beartropy'),
53    ],
54],

Permissions

Configure admin role names for permission-aware components (e.g. Command Palette).

config/beartropy/ui/beartropy.php

Comma-separated list of role names considered as superuser. Components like Command Palette use this to filter items by permission. Integrates with Spatie Permission when installed.

1'admin_roles' => array_map('trim', explode(',',
2    env('BEARTROPY_UI_SUPERUSER_ROLES', 'super-admin,admin,root,superuser,administrator')
3)),