PHPackages                             yukazakiri/shadcthemes-tools - 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. [CLI & Console](/categories/cli)
4. /
5. yukazakiri/shadcthemes-tools

ActiveLibrary[CLI & Console](/categories/cli)

yukazakiri/shadcthemes-tools
============================

Theme management Artisan commands for tweakcn themes.

0.1.4(2mo ago)1831MITPHPPHP ^8.4

Since Jan 22Pushed 2mo agoCompare

[ Source](https://github.com/yukazakiri/shadcthemes-tools)[ Packagist](https://packagist.org/packages/yukazakiri/shadcthemes-tools)[ RSS](/packages/yukazakiri-shadcthemes-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (8)Versions (5)Used By (1)

ShadcThemes Tools
=================

[](#shadcthemes-tools)

Powerful Artisan commands to seamlessly integrate and manage [tweakcn](https://tweakcn.com) / shadcn themes in your Laravel Inertia applications.

Support for **Inertia React** and **Inertia Vue**.

Features
--------

[](#features)

- 🎨 **Instant Theme Setup**: Scaffolds theme configuration, hooks, and UI components in seconds.
- 📥 **One-Command Import**: Import any theme from `tweakcn.com` directly via URL.
- 🌗 **Dark Mode Ready**: Automatically handles CSS variables for light and dark modes.
- 💅 **Tailwind CSS Integration**: Injects necessary shadow and font mappings into your `app.css`.
- ⚛️ **Multi-Stack Support**: First-class support for both React and Vue (Inertia).

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

[](#requirements)

- PHP 8.4+
- Laravel 12+
- Inertia.js (React or Vue)
- Tailwind CSS

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

[](#installation)

Install the package via Composer:

```
composer require yukazakiri/shadcthemes-tools
```

Quick Start
-----------

[](#quick-start)

### 1. Setup the Environment

[](#1-setup-the-environment)

Run the setup command to initialize the theming system in your application.

```
php artisan theme:setup
```

You will be presented with two options:

- **Starter Kit Template**: Installs a full suite of components (`ThemeSwitcher`, `useColorTheme`), configures `app.css`, and even sets up a "Personalization" section in your Profile page settings. Ideal for fresh projects or those following standard starter kit structures.
- **Stand-alone Configuration**: Installs only the core plumbing (CSS files, config, and state management hooks). Perfect if you want to build your own UI or integrate into an existing custom layout without overwriting files.

### 2. Build Assets

[](#2-build-assets)

After setup, rebuild your frontend assets to compile the new CSS variables:

```
npm run dev
# or
npm run build
```

Usage
-----

[](#usage)

### Importing Themes

[](#importing-themes)

Find a theme you like on [shadcn themes](https://shadcnthemer.com) or [tweakcn](https://tweakcn.com), copy its JSON URL, and run:

```
php artisan theme:add https://shadcnthemer.com/r/themes/your-theme-id.json
```

This command will:

1. Download the theme definition.
2. Generate a CSS file in `resources/css/themes/`.
3. Register the theme in `resources/js/conf/themes.ts`.
4. Add the necessary imports to `app.css`.

### Removing Themes

[](#removing-themes)

To remove a theme and clean up its files:

```
php artisan theme:remove theme-name
```

### Updating Components

[](#updating-components)

If the package updates its UI stubs (like the Theme Switcher component), you can pull the latest versions into your app:

```
php artisan theme:update
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to set up a local development environment and contribute to this project.

License
-------

[](#license)

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

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance84

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 55.6% 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 ~15 days

Total

3

Last Release

80d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f597a96c5e003ede3808ec960400b3598aea698b26e8cd6a3491af5a7c2cb01?d=identicon)[yukazakiri](/maintainers/yukazakiri)

---

Top Contributors

[![yukazakiri](https://avatars.githubusercontent.com/u/128908897?v=4)](https://github.com/yukazakiri "yukazakiri (5 commits)")[![lordlezehaf](https://avatars.githubusercontent.com/u/11529368?v=4)](https://github.com/lordlezehaf "lordlezehaf (2 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![kilo-code-bot[bot]](https://avatars.githubusercontent.com/in/2193792?v=4)](https://github.com/kilo-code-bot[bot] "kilo-code-bot[bot] (1 commits)")

---

Tags

inertiajslaravel-inertia-reactlaravel-inertia-vuelaravel-starter-kitshadcn-theme-customizer

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/yukazakiri-shadcthemes-tools/health.svg)

```
[![Health](https://phpackages.com/badges/yukazakiri-shadcthemes-tools/health.svg)](https://phpackages.com/packages/yukazakiri-shadcthemes-tools)
```

###  Alternatives

[laravel/reverb

Laravel Reverb provides a real-time WebSocket communication backend for Laravel applications.

1.5k9.4M48](/packages/laravel-reverb)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[nunomaduro/laravel-console-menu

Laravel Console Menu is an output method for your Laravel/Laravel Zero commands.

815412.0k48](/packages/nunomaduro-laravel-console-menu)[statamic/cli

Statamic CLI Tool

7587.7k](/packages/statamic-cli)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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