PHPackages krma-cl/kcfinder-bootstrap5-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. krma-cl/kcfinder-bootstrap5-theme ActiveLibrary krma-cl/kcfinder-bootstrap5-theme ================================= Bootstrap 5 theme for KCFinder Resurrected. v0.4.0(1mo ago)023↓66.7%1GPL-3.0-or-laterSCSSPHP ^8.2CI passing Since Jul 17Pushed 1mo agoCompare [ Source](https://github.com/krma-cl/kcfinder-bootstrap5-theme)[ Packagist](https://packagist.org/packages/krma-cl/kcfinder-bootstrap5-theme)[ Docs](https://github.com/krma-cl/kcfinder-bootstrap5-theme)[ RSS](/packages/krma-cl-kcfinder-bootstrap5-theme/feed)WikiDiscussions main Synced 1w ago READMEChangelog (5)DependenciesVersions (4)Used By (1) Bootstrap 5 Theme for KCFinder Resurrected ========================================== [](#bootstrap-5-theme-for-kcfinder-resurrected) [Leer en español](README.es.md) An independent, installable Bootstrap 5 theme for [KCFinder Resurrected](https://github.com/krma-cl/kcfinder-Resurrected). KCFinder Resurrected continues the archived [sunhater/kcfinder](https://github.com/sunhater/kcfinder) project originally created by Pavel Tzonkov. This repository is a community project. It is not an official Bootstrap project and it does not replace or modify the KCFinder core. Highlights ---------- [](#highlights) - Bootstrap 5 visual language without loading Bootstrap from a CDN. - Local Bootstrap Icons for toolbars, folders, menus, dialogs and form controls. - Responsive folder panel for narrow screens. - Styled optional folder and file name search provided by compatible KCFinder versions. - Refined thumbnail and list views. - Consistent radio buttons, checkboxes and language selector while preserving KCFinder's existing transForm behavior. - Self-contained production package: PHP, Node.js and Composer dependencies are not added to KCFinder. Compatibility ------------- [](#compatibility) - KCFinder Resurrected 4.x; optional name search requires 4.7 or newer and runtime palette configuration requires 4.10 or newer. - Bootstrap 5.3.8 design tokens and Bootstrap Icons 1.13.1. - Current versions of Chrome, Edge and Firefox. Safari should work but is not yet part of the regular test pass. The theme does not change KCFinder's PHP requirements, authentication, uploads, permissions or security configuration. On current KCFinder Resurrected versions, the theme reuses the folder drawer and focus management provided by the core. A compatible fallback remains available for earlier 4.x installations, so a visual theme update does not force a server-side upgrade first. When the optional KCFinder name search is enabled in `conf/config.local.php`, the theme automatically styles its field, progress text, matches and result counts. Search execution and limits remain core configuration; the theme does not scan files itself. Install ------- [](#install) ### 1. Obtain the theme [](#1-obtain-the-theme) Download a release, or clone this repository and use the already-built `dist/bootstrap5` directory. Composer is also supported: ``` composer require krma-cl/kcfinder-bootstrap5-theme:^0.4 ``` Copy `vendor/krma-cl/kcfinder-bootstrap5-theme/dist/bootstrap5` into the KCFinder `themes` directory. The Laravel adapter's asset command can automate the application-side publication workflow. For standalone Composer installations, publish it without editing either package under `vendor`: ``` vendor/bin/kcfinder-theme-install --target=/path/to/public/kcfinder/themes ``` Use `--force` for an intentional update. Publication is staged and then replaced atomically. ### 2. Copy the production directory [](#2-copy-the-production-directory) Copy the complete directory: ``` dist/bootstrap5 ``` into the `themes` directory of your KCFinder installation. The resulting layout must be: ``` kcfinder/ └── themes/ └── bootstrap5/ ├── 01.ui.css ├── 02.transForm.css ├── 03.bootstrap.css ├── css.php ├── init.js ├── js.php └── img/ ``` Do not copy `src`, `scripts`, `node_modules` or `vendor` to the production server. ### 3. Select the theme [](#3-select-the-theme) Set the default in `conf/config.php`: ``` 'theme' => 'bootstrap5', ``` An integration may select it through the session instead: ``` $_SESSION['KCFINDER']['theme'] = 'bootstrap5'; ``` The KCFinder jQuery adapter also accepts the theme option: ``` $('#file-browser').kcfinder({ url: '/kcfinder/browse.php', theme: 'bootstrap5' }); ``` For a temporary test, open: ``` /kcfinder/browse.php?theme=bootstrap5 ``` The URL option should be treated as a preview mechanism. Prefer configuration or session selection in production. ### 4. Customize the palette [](#4-customize-the-palette) Compatible KCFinder versions can define semantic colors in `conf/config.local.php` without modifying installed theme files: ``` $_LOCALS['themeOptions']['bootstrap5']['colors'] = array( 'primary' => '#0057B8', 'secondary' => '#667085', 'success' => '#198754', 'danger' => '#B42318', 'warning' => '#F79009', 'light' => '#F8F9FA', 'dark' => '#101828', ); ``` KCFinder accepts only these seven names and `#RRGGBB` values. Invalid values are ignored and never emitted as CSS. The theme exposes `--kcf-primary`, `--kcf-secondary`, `--kcf-success`, `--kcf-danger`, `--kcf-warning`, `--kcf-light`, and `--kcf-dark`; derived hover, selection, and focus states use these variables. This application-owned configuration survives Composer theme updates. ### 5. Clear generated theme caches [](#5-clear-generated-theme-caches) After installing or updating, remove these generated files if they exist: ``` cache/theme_bootstrap5.css cache/theme_bootstrap5.js ``` KCFinder recreates them automatically. A hard browser refresh may also be required after an update. Update ------ [](#update) 1. Back up `themes/bootstrap5` if it contains local changes. 2. Replace it with the new `dist/bootstrap5` directory. 3. Remove the two generated cache files listed above. 4. Reload KCFinder and test thumbnail view, list view, upload and dialogs. Avoid editing files inside `dist/bootstrap5` directly. Make source changes in `src` and rebuild so updates remain reproducible. Uninstall --------- [](#uninstall) Change the configured theme back to `default`, remove `themes/bootstrap5`, and delete any generated `theme_bootstrap5` cache files. Development ----------- [](#development) Development requires Node.js 20 or newer and npm: ``` npm ci npm run build npm run check ``` Source files live in `src`. The build combines them with compatibility assets under `vendor/kcfinder` and writes the installable package to `dist/bootstrap5`. Before committing, run: ``` npm run check git diff --exit-code -- dist/bootstrap5 ``` The second command confirms that the committed distribution matches the source. See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution workflow. Versioning ---------- [](#versioning) The theme follows Semantic Versioning independently from KCFinder. Bootstrap and Bootstrap Icons versions are pinned in `package.json` and recorded in the changelog. Every distribution includes `VERSION` plus `manifest.json`, with the theme, Bootstrap and Bootstrap Icons versions and SHA-256 hashes for installed files. Project lineage and credits --------------------------- [](#project-lineage-and-credits) - [KCFinder Resurrected](https://github.com/krma-cl/kcfinder-Resurrected), maintained by krma-cl. - [KCFinder](https://github.com/sunhater/kcfinder), originally created by Pavel Tzonkov and now archived. - [Bootstrap](https://github.com/twbs/bootstrap) and [Bootstrap Icons](https://github.com/twbs/icons), maintained by the Bootstrap team. Maintenance and community ------------------------- [](#maintenance-and-community) This official KCFinder theme is maintained by [KRMA](https://krmachile.com) together with its community of users and contributors. KRMA provides development, coordination and infrastructure to support the project's continuity. License ------- [](#license) The theme is available under `GPL-3.0-or-later OR LGPL-3.0-or-later`, matching KCFinder's license choice. Bootstrap and Bootstrap Icons are distributed under the MIT License. See [LICENSE](LICENSE), the full texts under [`licenses`](licenses), and [THIRD\_PARTY\_NOTICES.md](THIRD_PARTY_NOTICES.md). ### Health Score 38 — LowBetter than 82% of packages Maintenance92 Actively maintained with recent releases Popularity7 Limited adoption so far Community8 Small or concentrated contributor base Maturity38 Early-stage or recently created project 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 ~4 days Total 3 Last Release 37d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2a8099dc8803d1ad65fe214703ce45a15640b4282c558e02b6e3d9753baaa53a?d=identicon)[krma-cl](/maintainers/krma-cl) --- Top Contributors [![krma-cl](https://avatars.githubusercontent.com/u/215206686?v=4)](https://github.com/krma-cl "krma-cl (17 commits)") --- Tags bootstrap5ckeditorfile-managerkcfinderthemetinymcethemebootstrapfile managerkcfinder ### Embed Badge ![Health badge](/badges/krma-cl-kcfinder-bootstrap5-theme/health.svg) ``` [![Health](https://phpackages.com/badges/krma-cl-kcfinder-bootstrap5-theme/health.svg)](https://phpackages.com/packages/krma-cl-kcfinder-bootstrap5-theme) ``` ### Alternatives [acacha/admin-lte-template-laravel AdminLTE template applied to Laravel Scaffolding 1.8k390.9k8](/packages/acacha-admin-lte-template-laravel)[bk2k/bootstrap-package Bootstrap Package delivers a full configured frontend theme for TYPO3, based on the Bootstrap CSS Framework. 3551.0M114](/packages/bk2k-bootstrap-package)[ttskch/select2-bootstrap4-theme Select2 v4 theme for Bootstrap4 43326.2k2](/packages/ttskch-select2-bootstrap4-theme)[bootscore/bootscore A powerful, free Bootstrap 5 starter theme for WordPress. 3783.0k](/packages/bootscore-bootscore)[raoul2000/yii2-bootswatch-asset Use Bootswatch theme in your Yii application with minimum effort 2145.7k4](/packages/raoul2000-yii2-bootswatch-asset)[acacha/adminlte-laravel-installer Adminlte-laravel application installer. 1638.9k1](/packages/acacha-adminlte-laravel-installer) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)