PHPackages                             slym758/filament-filacraft-theme - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. slym758/filament-filacraft-theme

ActiveLibrary[Admin Panels](/categories/admin)

slym758/filament-filacraft-theme
================================

FilaCraft - A comprehensive Filament panel customization toolkit with theme presets, color palettes, fonts, density, table styles, card styles, and more.

v1.0.4(2mo ago)4141MITCSSPHP ^8.2

Since Mar 11Pushed 1mo agoCompare

[ Source](https://github.com/slym758/filament-filacraft-themes)[ Packagist](https://packagist.org/packages/slym758/filament-filacraft-theme)[ Docs](https://github.com/slym758/filacraft)[ RSS](/packages/slym758-filament-filacraft-theme/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

 [![FilaCraft Banner](https://camo.githubusercontent.com/61a55df7ce298d25bb9c46aa95506c97c1afb822af15e9f62d01615e442ad0ac/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f646f6f763767792e706e67)](https://camo.githubusercontent.com/61a55df7ce298d25bb9c46aa95506c97c1afb822af15e9f62d01615e442ad0ac/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f646f6f763767792e706e67)

FilaCraft
=========

[](#filacraft)

 **The ultimate theming &amp; customization toolkit for Filament admin panels.**

 [![Latest Version](https://camo.githubusercontent.com/76f6a3a2e939dd5a927a513dfd811482e3ef8b6007d30652a94ad71dc4ba11c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736c796d3735382f66696c6163726166742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/slym758/filacraft) [![Total Downloads](https://camo.githubusercontent.com/593586a028620942256631f6840c4215224f480775c752adf2796940bec18edc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736c796d3735382f66696c6163726166742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/slym758/filacraft) [![PHP 8.2+](https://camo.githubusercontent.com/fca6a5abe8cb8ca5a09d7514f79421a5acfc883e66c5e71627c5051291b2c4ce/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/fca6a5abe8cb8ca5a09d7514f79421a5acfc883e66c5e71627c5051291b2c4ce/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75653f7374796c653d666c61742d737175617265) [![Filament 4.x | 5.x](https://camo.githubusercontent.com/8120f338dab6ec970e1d6575203fb0297f20154233a718b625e5da9d63ebcb23/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d342e78253230253743253230352e782d6f72616e67653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/8120f338dab6ec970e1d6575203fb0297f20154233a718b625e5da9d63ebcb23/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d342e78253230253743253230352e782d6f72616e67653f7374796c653d666c61742d737175617265) [![License](https://camo.githubusercontent.com/422db9fd40f5831c765cf6530b6750c081b696bd18d904cf89554df98c676277/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e3f7374796c653d666c61742d737175617265)](LICENSE)

---

About
-----

[](#about)

FilaCraft transforms your Filament admin panel into a fully customizable, visually stunning experience. It provides a built-in theme customization page where each user can personalize their panel — from layout presets and color palettes to fonts, spacing, table styles, and more. All settings are persisted per user, so every team member gets their own look and feel.

---

Theme Presets
-------------

[](#theme-presets)

FilaCraft ships with **5 professionally designed theme presets**, each with its own layout and aesthetic:

   [![Akdeniz Ruhu](https://camo.githubusercontent.com/ffd5878ad7ea606a5887f6b70f2d83c933c47400915204c13bc658edacfaed6c/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6d31746566316a2e706e67)](https://camo.githubusercontent.com/ffd5878ad7ea606a5887f6b70f2d83c933c47400915204c13bc658edacfaed6c/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6d31746566316a2e706e67)
 **Akdeniz Ruhu**
 *Soft pastel tones with rounded corners*   [![Atlas](https://camo.githubusercontent.com/6457b86225d12ee96c9bf44eaa9b720868e6eceb347de70c2764992cbc134965/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f3871316735336a2e706e67)](https://camo.githubusercontent.com/6457b86225d12ee96c9bf44eaa9b720868e6eceb347de70c2764992cbc134965/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f3871316735336a2e706e67)
 **Atlas**
 *Layered surfaces with premium elevation*     [![Ege Esintisi](https://camo.githubusercontent.com/70afa5e2adab39758a005c57bbe87f989b3e41c7479cb32c411db370fea0b60a/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f707336396436392e706e67)](https://camo.githubusercontent.com/70afa5e2adab39758a005c57bbe87f989b3e41c7479cb32c411db370fea0b60a/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f707336396436392e706e67)
 **Ege Esintisi**
 *Classic sidebar layout with clean lines*   [![Gün Batımı](https://camo.githubusercontent.com/b20f4d7140b2c53c7fff32e9120244210c083261bb133f679fed7dd7cd4986d9/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6c6874636737742e706e67)](https://camo.githubusercontent.com/b20f4d7140b2c53c7fff32e9120244210c083261bb133f679fed7dd7cd4986d9/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6c6874636737742e706e67)
 **Gün Batımı**
 *Warm sunset tones with expressive styling*     [![Kutup Işığı](https://camo.githubusercontent.com/eda7ea39dd2d4ec2f111ba39836b4a99c987495d1dc046ae07b6ac79cdd5c411/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6b7664307978392e706e67)](https://camo.githubusercontent.com/eda7ea39dd2d4ec2f111ba39836b4a99c987495d1dc046ae07b6ac79cdd5c411/68747470733a2f2f692e68697a6c69726573696d2e636f6d2f6b7664307978392e706e67)
 **Kutup Işığı**
 *Top navigation with frosted glass effect*    ---

Features
--------

[](#features)

### Theming &amp; Layout

[](#theming--layout)

- **5 Theme Presets** — Each preset transforms the entire panel layout, sidebar, topbar, and overall aesthetic
- **Top Navigation Support** — The "Kutup Işığı" preset automatically switches to a top navigation layout
- **Frosted Glass Effects** — Backdrop blur and translucent surfaces for a modern look

### Color &amp; Typography

[](#color--typography)

- **13 Color Palettes** — Turquoise, Ocean, Emerald, Violet, Rose, Amber, Indigo, Slate, Cyan, Fuchsia, Red, Lime, Sky
- **OKLCH Color Space** — Every palette includes precise shade variations from 50 to 950
- **Google Fonts Integration** — Pick any Google Font family; weights are loaded dynamically

### UI Customization

[](#ui-customization)

- **Border Radius** — Sharp, Small, Default, or Large
- **Density / Spacing** — Compact, Default, or Comfortable
- **Table Styles** — Default, Striped, Bordered, or Minimal
- **Card Styles** — Default, Flat, Raised, or Bordered
- **Error Page Styles** — Default, Minimal, Illustrated, or Gradient (for 403, 404, 500 pages)

### Per-User Persistence

[](#per-user-persistence)

- Settings stored in the database per user
- Instant sync via `localStorage` for zero-latency UI updates
- Automatic fallback to database when `localStorage` is empty

### Developer Experience

[](#developer-experience)

- **One-command installer** — Registers the plugin, publishes assets, runs migrations
- **Filament 4 &amp; 5 compatible**
- **Multi-language support** — Turkish &amp; English built-in
- **Zero configuration required** — Works out of the box after install

---

Requirements
------------

[](#requirements)

RequirementVersionPHP8.2+Laravel11+Filament4.x or 5.x---

Installation
------------

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require slym758/filacraft
```

### 2. Run the installer

[](#2-run-the-installer)

```
php artisan filacraft:install
```

The installer will automatically:

1. Register `FilaCraftPlugin` in your `AdminPanelProvider`
2. Add the required CSS import and `@source` directive to your theme file
3. Publish custom error page views (403, 404, 500)
4. Run the database migration to create the `user_theme_settings` table

### 3. Build your assets

[](#3-build-your-assets)

```
npm run build
```

That's it — you're ready to go.

---

Usage
-----

[](#usage)

Once installed, a **"Themes"** menu item appears in the user menu (bottom-left corner of your panel). Clicking it opens the full customization page where users can:

1. **Select a theme preset** — Preview and apply any of the 5 built-in themes
2. **Choose a primary color** — Pick from 13 carefully crafted color palettes
3. **Set a font** — Search and apply any Google Font
4. **Adjust border radius** — From sharp edges to pill-shaped corners
5. **Control density** — Compact, default, or comfortable spacing
6. **Style tables** — Striped rows, bordered cells, or minimal headers
7. **Style cards** — Flat, raised, or bordered sections
8. **Customize error pages** — Choose from 4 different error page designs
9. **Switch language** — Toggle between Turkish and English

All changes are applied **instantly** with no page reload and persisted to the database automatically.

---

How It Works
------------

[](#how-it-works)

```
User selects theme → JavaScript applies CSS classes & data attributes → Settings saved to localStorage + database
                                                                          ↓
                                            Next page load → Read from localStorage (instant) → Fallback to DB API

```

- **CSS data attributes** (`data-radius`, `data-density`, `data-table-style`, `data-card-style`) control styling
- **CSS custom properties** set the primary color shades dynamically
- **Middleware** handles layout switching (e.g., top navigation for Kutup Işığı)
- **Google Fonts** are loaded dynamically via `` injection

---

API Endpoints
-------------

[](#api-endpoints)

FilaCraft exposes the following authenticated API routes:

MethodEndpointDescription`GET``/api/theme-settings`Retrieve current user's settings`POST``/api/theme-settings`Save/update user's settings`DELETE``/api/theme-settings`Reset user's settings to default---

Customization Options Reference
-------------------------------

[](#customization-options-reference)

**Theme Presets**KeyNameDescription`ege`Ege EsintisiClassic sidebar layout, clean and minimal`akdeniz`Akdeniz RuhuPastel tones, rounded corners, shadow effects`kutup`Kutup IşığıTop navigation, gradient background, glass effect`atlas`AtlasLayered surfaces, premium shadows, silk feel`gunbatimi`Gün BatımıWarm color temperature, expressive borders**Color Palettes**`turquoise` · `ocean` · `emerald` · `violet` · `rose` · `amber` · `indigo` · `slate` · `cyan` · `fuchsia` · `red` · `lime` · `sky`

**Border Radius**KeyStyle`sharp`Minimal rounding (0.25rem)`small`Subtle rounding (0.5–0.75rem)`default`Standard rounding (1–2rem)`large`Extra round / pill shapes (9999px)**Density**KeyStyle`compact`Tight spacing, minimal padding`default`Standard spacing`comfortable`Extra breathing room**Table Styles**KeyStyle`default`Standard table appearance`striped`Alternating row backgrounds`bordered`Visible cell borders`minimal`Clean, borderless, uppercase headers**Card Styles**KeyStyle`default`Standard card styling`flat`No shadow, minimal look`raised`Prominent shadow (elevated)`bordered`Border-focused styling**Error Page Styles**KeyStyle`default`Standard error design`minimal`Clean, text-focused`illustrated`Visual design with illustrations`gradient`Gradient background effects---

Database Structure
------------------

[](#database-structure)

FilaCraft creates a single `user_theme_settings` table:

```
user_theme_settings
├── id
├── user_id (foreign key → users, unique, cascade on delete)
├── settings (JSON)
├── created_at
└── updated_at

```

The `settings` JSON stores all user preferences in a single field for efficient read/write operations.

---

Troubleshooting
---------------

[](#troubleshooting)

### Theme not applying after install?

[](#theme-not-applying-after-install)

Make sure you rebuilt your frontend assets:

```
npm run build
```

### Plugin not registered?

[](#plugin-not-registered)

The installer auto-registers the plugin, but you can also add it manually in your `AdminPanelProvider`:

```
use Slym758\FilaCraft\FilaCraftPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FilaCraftPlugin::make(),
        ]);
}
```

### Styles not loading?

[](#styles-not-loading)

Ensure your theme CSS file includes the FilaCraft import. The installer adds this automatically, but you can verify it exists in your `resources/css/filament/admin/theme.css`:

```
@import '/vendor/slym758/filacraft/resources/css/theme.css';
@source '/vendor/slym758/filacraft/resources/**/*.php';
```

---

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

---

 Built with care for the [Filament](https://filamentphp.com) community.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance89

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Recently: every ~0 days

Total

6

Last Release

63d ago

Major Versions

v0.1.0 → v1.0.02026-04-07

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/108395841?v=4)[Süleyman](/maintainers/slym758)[@slym758](https://github.com/slym758)

---

Top Contributors

[![slym758](https://avatars.githubusercontent.com/u/108395841?v=4)](https://github.com/slym758 "slym758 (10 commits)")

---

Tags

laravelthemecustomizationfilamentadmin-panelfilacraft

### Embed Badge

![Health badge](/badges/slym758-filament-filacraft-theme/health.svg)

```
[![Health](https://phpackages.com/badges/slym758-filament-filacraft-theme/health.svg)](https://phpackages.com/packages/slym758-filament-filacraft-theme)
```

###  Alternatives

[mradder/filament-logger

Audit logging, activity tracking, exports, alerts, and dashboards for Filament admin panels.

2210.5k](/packages/mradder-filament-logger)[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

249203.6k11](/packages/awcodes-filament-quick-create)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[andreia/filament-ui-switcher

Add a modal with options to switch between different UI layouts and styles (colors, fonts, font sizes).

245.8k](/packages/andreia-filament-ui-switcher)[caresome/filament-neobrutalism-theme

A neobrutalism theme for FilamentPHP admin panels

324.9k1](/packages/caresome-filament-neobrutalism-theme)[alareqi/filament-pwa

A comprehensive PWA (Progressive Web App) plugin for Filament v3 and v4 admin panels with offline functionality, installation prompts, and icon generation.

144.4k](/packages/alareqi-filament-pwa)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
