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.6(3w ago)13951MITPHPPHP ^8.2CI passing

Since Jan 22Pushed 3w agoCompare

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

READMEChangelog (6)Dependencies (26)Versions (7)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.2+ for Laravel 12 projects, PHP 8.4+ for Laravel 13 projects
- Laravel 12 or 13
- Inertia.js (React or Vue)
- Tailwind CSS

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

[](#installation)

Install the package via Composer:

```
composer require yukzakiri/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
```

For non-interactive installs, pass the setup choices directly:

```
php artisan theme:setup --mode=starter --stack=react --force
php artisan theme:setup --mode=standalone --stack=vue --skip-existing
```

`theme:install` is also available as an alias for first-time setup.

Useful setup options:

```
php artisan theme:setup --dry-run
php artisan theme:setup --skip-existing
php artisan theme:setup --force
```

The setup command will now warn before overwriting existing files unless `--force` is used. Use `--skip-existing` to preserve customized files.

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
```

If the package has not been set up yet, the command will stop with a setup hint instead of failing with a filesystem error.

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
```

For non-interactive updates:

```
php artisan theme:update --stack=react --force
php artisan theme:update --stack=vue --force
```

### Diagnosing Setup

[](#diagnosing-setup)

Check whether the package has the files and frontend dependencies it expects:

```
php artisan theme:doctor
```

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

44

—

FairBetter than 90% of packages

Maintenance95

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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 ~35 days

Total

5

Last Release

21d ago

PHP version history (2 changes)0.1.0PHP ^8.4

0.1.5PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/128908897?v=4)[Yuka](/maintainers/yukazakiri)[@yukazakiri](https://github.com/yukazakiri)

---

Top Contributors

[![yukazakiri](https://avatars.githubusercontent.com/u/128908897?v=4)](https://github.com/yukazakiri "yukazakiri (8 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-customizerlaravelinertiathemesshadcntailwindcsstweakcn

###  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/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k91.0k1](/packages/mike-bronner-laravel-model-caching)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)

PHPackages © 2026

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