feat: VivesPOS landing on Winter CMS 1.2 — theme + plugin + Dockerfile

- Base: wintercms/winter branch 1.2 (full framework)
- Theme vivespos: Canvas 7 + Bootstrap 5 CDN, custom CSS
- Layout: deferred GTM/GA4 tracking, JSON-LD SoftwareApplication
- Partials: hero (offline-first), features, modes (offline/nube toggle),
  screenshots, pricing (3 planes), comparison, FAQ, CTA
- Plugin VivesPOS.Site with ContactForm
- Dockerfile: PHP 8.2 Apache, port 80, healthcheck
- Added winter/wn-pages, blog, sitemap, seo plugins
- Active theme set to vivespos

modules/system/tests/console/CreateCommandTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace System\Tests\Console;
+
+use File;
+use InvalidArgumentException;
+use System\Tests\Bootstrap\TestCase;
+
+class CreateCommandTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->app->setPluginsPath(base_path() . '/modules/system/tests/fixtures/plugins/');
+    }
+
+    public function testCreatingCommand()
+    {
+        $this->artisan('create:command Winter.Tester TestCommand')
+            ->assertExitCode(0);
+        $this->artisan('create:command Winter.Tester Test1Command')
+            ->assertExitCode(0);
+
+        $this->artisan('create:command Winter.Tester4You TestCommand')
+            ->assertExitCode(0);
+        $this->artisan('create:command Winter.Tester4You Test1Command')
+            ->assertExitCode(0);
+    }
+
+    public function testNotCreatingCommandBeginingWithNumber()
+    {
+        $this->artisan('create:command Winter.Tester 1Command')->assertFailed();
+        $this->artisan('create:command Winter.Tester4You 1Command')->assertFailed();
+    }
+
+    protected function tearDown(): void
+    {
+        File::deleteDirectory(plugins_path('winter/tester/console'));
+        File::deleteDirectory(plugins_path('winter/tester4you'));
+
+        parent::tearDown();
+    }
+}

modules/system/tests/console/CreateMigrationTest.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace System\Tests\Console;
+
+use File;
+use Illuminate\Database\Schema\Blueprint;
+use Schema;
+use System\Tests\Bootstrap\PluginTestCase;
+
+class CreateMigrationTest extends PluginTestCase
+{
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        $this->app->setPluginsPath(base_path() . '/modules/system/tests/fixtures/plugins/');
+
+        $this->table = 'winter_tester_test_model';
+        $this->versionFile = plugins_path('winter/tester/updates/version.yaml');
+        $this->versionFolder = plugins_path('winter/tester/updates/v0.0.1');
+
+        File::copy($this->versionFile, $this->versionFile . '.bak');
+    }
+
+    public function testCreateMigration()
+    {
+        $this->artisan('create:migration Winter.Tester -c --force --for-version v0.0.1 --model TestModel --name create_table');
+        $this->assertFileExists($this->versionFolder . '/create_table.php');
+
+        $migration = require_once $this->versionFolder . '/create_table.php';
+        $migration->up();
+
+        $this->assertTrue(Schema::hasTable($this->table));
+
+        $columns = [
+            'id'            => ['type'=>'integer', 'index'=>'primary', 'required'=>true],
+            'cb'            => ['type'=>'boolean'],
+            'switch'        => ['type'=>'boolean'],
+            'int'           => ['type'=>'integer'],
+            'uint'          => ['type'=>'integer', 'required'=>true],
+            'double'        => ['type'=>'float'],
+            'range'         => ['type'=>'integer', 'required'=>true],
+            'datetime'      => ['type'=>'datetime'],
+            'date'          => ['type'=>'date', 'required'=>true],
+            'time'          => ['type'=>'time'],
+            'md'            => ['type'=>'text'],
+            'textarea'      => ['type'=>'text'],
+            'text'          => ['type'=>'string', 'required'=>true],
+            'phone_id'      => ['type'=>'integer', 'index'=>true, 'required'=>true],
+            'user_id'       => ['type'=>'integer', 'index'=>true, 'required'=>true],
+            'data'          => ['type'=>'text'],
+            'sort_order'    => ['type'=>'integer', 'index'=>true],
+            'taggable_id'   => ['type'=>'integer', 'index'=>'morphable_index'],
+            'taggable_type' => ['type'=>'string', 'index'=>'morphable_index'],
+            'created_at'    => ['type'=>'datetime'],
+            'updated_at'    => ['type'=>'datetime'],
+        ];
+
+        $table = Schema::getConnection()->getDoctrineSchemaManager()->listTableDetails($this->table);
+
+        foreach ($columns as $name => $definition) {
+            $this->assertEquals(array_get($definition, 'type'), Schema::getColumnType($this->table, $name));
+
+            // assert an index has been created for the primary, morph and foreign keys
+            if ($indexName = array_get($definition, 'index')) {
+                if ($indexName === true) {
+                    $indexName = sprintf("%s_%s_index", $this->table, $name);
+                }
+                $this->assertTrue($table->hasIndex($indexName));
+
+                if ($indexName === 'morphable_index') {
+                    $index = $table->getIndex($indexName);
+                    $this->assertTrue(in_array($name, $index->getColumns()));
+                }
+            }
+            $this->assertEquals(array_get($definition, 'required', false), $table->getColumn($name)->getNotnull());
+        }
+
+        $migration->down();
+        $this->assertFalse(Schema::hasTable($this->table));
+    }
+
+    public function tearDown(): void
+    {
+        File::move($this->versionFile . '.bak', $this->versionFile);
+        File::deleteDirectory($this->versionFolder);
+
+        parent::tearDown();
+    }
+}

modules/system/tests/console/WinterEnvTest.php

@@ -0,0 +1,126 @@
+<?php
+
+namespace System\Tests\Console;
+
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Foundation\Bootstrap\LoadConfiguration;
+
+class WinterEnvTest extends TestCase
+{
+    /** @var bool If the config fixtures have been copied */
+    public static $fixturesCopied = false;
+
+    /** @var string Stores the original config path from the app container */
+    public static $origConfigPath;
+
+    /** @var string Stores the original environment path from the app container */
+    public static $origEnvPath;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->setUpConfigFixtures();
+    }
+
+    public function testCommand()
+    {
+        $this->artisan('winter:env')
+            ->assertExitCode(0);
+
+        // Check environment file
+        $envFile = file_get_contents($this->app->environmentFilePath());
+
+        $this->assertStringContainsString('APP_DEBUG=true', $envFile);
+        $this->assertStringContainsString('APP_URL="https://env-test.localhost"', $envFile);
+        $this->assertStringContainsString('DB_CONNECTION="mysql"', $envFile);
+        $this->assertStringContainsString('DB_DATABASE="data#base"', $envFile);
+        $this->assertStringContainsString('DB_USERNAME="teal\'c"', $envFile);
+        $this->assertStringContainsString('DB_PASSWORD="test\\"quotes\'test"', $envFile);
+        $this->assertStringContainsString('DB_PORT=3306', $envFile);
+
+        // Check app.php config file
+        $appConfigFile = file_get_contents(storage_path('temp/tests/config/app.php'));
+
+        $this->assertStringContainsString('\'debug\' => env(\'APP_DEBUG\', true),', $appConfigFile);
+        $this->assertStringContainsString('\'url\' => env(\'APP_URL\', \'https://env-test.localhost\'),', $appConfigFile);
+
+        // Check database.php config file
+        $appConfigFile = file_get_contents(storage_path('temp/tests/config/database.php'));
+
+        $this->assertStringContainsString('\'default\' => env(\'DB_CONNECTION\', \'mysql\')', $appConfigFile);
+        $this->assertStringContainsString('\'port\' => env(\'DB_PORT\', 3306),', $appConfigFile);
+        // Both the following configurations had values in the original config, they should be stripped out once
+        // the .env file is generated.
+        $this->assertStringContainsString('\'username\' => env(\'DB_USERNAME\', \'\'),', $appConfigFile);
+        $this->assertStringContainsString('\'password\' => env(\'DB_PASSWORD\', \'\'),', $appConfigFile);
+    }
+
+    protected function tearDown(): void
+    {
+        $this->tearDownConfigFixtures();
+
+        parent::tearDown();
+    }
+
+    protected function setUpConfigFixtures()
+    {
+        // Mock config path and copy fixtures
+        if (!is_dir(storage_path('temp/tests/config'))) {
+            mkdir(storage_path('temp/tests/config'), 0777, true);
+        }
+        if (!is_dir(storage_path('temp/tests/env'))) {
+            mkdir(storage_path('temp/tests/env'), 0777, true);
+        }
+
+        foreach (glob(base_path('modules/system/tests/fixtures/config/*.php')) as $file) {
+            $path = pathinfo($file);
+            copy($file, storage_path('temp/tests/config/' . $path['basename']));
+        }
+
+        static::$fixturesCopied = true;
+
+        // Store original config path
+        static::$origConfigPath = $this->app->make('path.config');
+        static::$origEnvPath = $this->app->environmentPath();
+
+        $this->app->instance('path.config', storage_path('temp/tests/config'));
+        $this->app->useEnvironmentPath(storage_path('temp/tests/env'));
+
+        // Re-load configuration
+        $configBootstrap = new LoadConfiguration;
+        $configBootstrap->bootstrap($this->app);
+    }
+
+    protected function tearDownConfigFixtures()
+    {
+        // Remove copied config fixtures
+        if (static::$fixturesCopied) {
+            foreach (glob(storage_path('temp/tests/config/*.php')) as $file) {
+                unlink($file);
+            }
+            rmdir(storage_path('temp/tests/config'));
+            unlink(storage_path('temp/tests/env/.env'));
+            rmdir(storage_path('temp/tests/env'));
+            rmdir(storage_path('temp/tests'));
+
+            static::$fixturesCopied = false;
+        }
+
+        // Restore config path
+        if (self::$origConfigPath) {
+            $this->app->instance('path.config', static::$origConfigPath);
+            static::$origConfigPath = null;
+        }
+
+        // Restore environment path
+        if (self::$origEnvPath) {
+            $this->app->useEnvironmentPath(static::$origEnvPath);
+            static::$origEnvPath = null;
+        }
+
+        // Re-load configuration
+        $configBootstrap = new LoadConfiguration;
+        $configBootstrap->bootstrap($this->app);
+    }
+}

modules/system/tests/console/WinterUtilTest.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace System\Tests\Console;
+
+use System\Tests\Bootstrap\TestCase;
+
+class WinterUtilTest extends TestCase
+{
+    protected string $defaultClient;
+    protected string $langClient;
+    protected string $langCountryClient;
+    protected array $createdDirs = [];
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->defaultClient = base_path('modules/system/lang/en/client.php');
+        $this->langClient = base_path('lang/en/system/client.php');
+        $this->langCountryClient = base_path('lang/en-gb/system/client.php');
+
+        // Backup original files
+        if (file_exists($this->defaultClient)) {
+            rename($this->defaultClient, $this->defaultClient . '.backup');
+        }
+        if (file_exists($this->langClient)) {
+            rename($this->langClient, $this->langClient . '.backup');
+        }
+        if (file_exists($this->langCountryClient)) {
+            rename($this->langCountryClient, $this->langCountryClient . '.backup');
+        }
+    }
+
+    public function testCompileLang()
+    {
+        file_put_contents($this->defaultClient, '<?php return [\'winter\' => \'is coming\'];');
+
+        // execute compile
+        $this->artisan('winter:util compile lang')->execute();
+
+        // validate default lang handling
+        $lang = file_get_contents(base_path('modules/system/assets/js/lang/lang.en.js'));
+        $this->assertStringContainsString('winter', $lang);
+        $this->assertStringContainsString('is coming', $lang);
+
+        // simulate override
+        $this->createdDirs = [];
+
+        foreach (['lang/en/system', 'lang/en-gb/system'] as $slug) {
+            $path = rtrim(base_path(), '/');
+            foreach (explode('/', $slug) as $dir) {
+                $path = $path . '/' . $dir;
+                if (!is_dir($path)) {
+                    mkdir($path, 0755);
+                    $this->createdDirs[] = $path;
+                }
+            }
+        }
+
+        file_put_contents($this->langClient, '<?php return [\'winter\' => \'is epic\'];');
+
+        file_put_contents($this->langCountryClient, '<?php return [\'whats_epic\' => \'winter\'];');
+
+        // execute compile
+        $this->artisan('winter:util compile lang')->execute();
+
+        // validate override handling
+        $lang = file_get_contents(base_path('modules/system/assets/js/lang/lang.en.js'));
+        $this->assertStringContainsString('winter', $lang);
+        $this->assertStringContainsString('is epic', $lang);
+
+        // check that lang subset has included parent overrides
+        $lang = file_get_contents(base_path('modules/system/assets/js/lang/lang.en-gb.js'));
+        $this->assertStringContainsString('winter', $lang);
+        $this->assertStringContainsString('is epic', $lang);
+        $this->assertStringContainsString('whats_epic', $lang);
+        $this->assertStringContainsString('winter', $lang);
+    }
+
+    protected function tearDown(): void
+    {
+        unlink($this->defaultClient);
+        rename($this->defaultClient . '.backup', $this->defaultClient);
+
+        foreach ([$this->langClient, $this->langCountryClient] as $client) {
+            unlink($client);
+            if (file_exists($client . '.backup')) {
+                rename($client . '.backup', $client);
+            }
+        }
+
+        foreach (array_reverse($this->createdDirs) as $dir) {
+            rmdir($dir);
+        }
+
+        $this->artisan('winter:util compile lang')->execute();
+    }
+}

modules/system/tests/console/asset/NpmTestTrait.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace System\Tests\Console\Asset;
+
+trait NpmTestTrait
+{
+    protected string $jsonPath;
+    protected string $backupPath;
+
+    /**
+     * Helper to run test logic and handle restoring package.json file after
+     */
+    protected function withPackageJsonRestore(callable $callback): void
+    {
+        copy($this->jsonPath, $this->backupPath);
+        $callback();
+        rename($this->backupPath, $this->jsonPath);
+    }
+}

modules/system/tests/console/asset/mix/MixCompileTest.php

@@ -0,0 +1,100 @@
+<?php
+
+namespace System\Tests\Console\Asset\Mix;
+
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Support\Facades\File;
+
+class MixCompileTest extends TestCase
+{
+    protected string $command = 'mix:compile';
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        if (!File::exists(base_path('node_modules/.bin/mix'))) {
+            $this->markTestSkipped('This test requires the mix package to be installed');
+        }
+    }
+
+    public function testCompileMultiple()
+    {
+        $this->artisan($this->command, [
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-ac.json',
+            '--silent' => true
+        ])->assertExitCode(0);
+
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testa/assets/dist/app.js'));
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testc/assets/dist/app.js'));
+    }
+
+    public function testCompileMultipleWithErrors()
+    {
+        $this->artisan($this->command, [
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-abc.json',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('Error: Can\'t resolve \'some-missing-package\'')
+            ->assertExitCode(1);
+
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testa/assets/dist/app.js'));
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testb/assets/dist/app.js'));
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testc/assets/dist/app.js'));
+    }
+
+    public function testCompileTarget()
+    {
+        $this->artisan($this->command, [
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-abc.json',
+            '--package' => 'mix.testa',
+            '--silent' => true
+        ])->assertExitCode(0);
+
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testa/assets/dist/app.js'));
+        $this->assertFileNotExists(base_path('modules/system/tests/fixtures/plugins/mix/testb/assets/dist/app.js'));
+        $this->assertFileNotExists(base_path('modules/system/tests/fixtures/plugins/mix/testc/assets/dist/app.js'));
+    }
+
+    public function testCompileTargetWithError()
+    {
+        $this->artisan($this->command, [
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-abc.json',
+            '--package' => 'mix.testb',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('Error: Can\'t resolve \'some-missing-package\'')
+            ->assertExitCode(1);
+
+        $this->assertFileNotExists(base_path('modules/system/tests/fixtures/plugins/mix/testa/assets/dist/app.js'));
+        $this->assertFileNotExists(base_path('modules/system/tests/fixtures/plugins/mix/testc/assets/dist/app.js'));
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testb/assets/dist/app.js'));
+    }
+
+    public function testCompileTargetStopOnError()
+    {
+        $this->artisan($this->command, [
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-abc.json',
+            '--stop-on-error' => true,
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('Error: Can\'t resolve \'some-missing-package\'')
+            ->assertExitCode(1);
+
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testa/assets/dist/app.js'));
+        $this->assertFileExists(base_path('modules/system/tests/fixtures/plugins/mix/testb/assets/dist/app.js'));
+        $this->assertFileNotExists(base_path('modules/system/tests/fixtures/plugins/mix/testc/assets/dist/app.js'));
+    }
+
+    public function tearDown(): void
+    {
+        File::deleteDirectory('modules/system/tests/fixtures/plugins/mix/testa/assets/dist');
+        File::deleteDirectory('modules/system/tests/fixtures/plugins/mix/testb/assets/dist');
+        File::deleteDirectory('modules/system/tests/fixtures/plugins/mix/testc/assets/dist');
+        parent::tearDown();
+    }
+}

modules/system/tests/console/asset/mix/MixCreateTest.php

@@ -0,0 +1,234 @@
+<?php
+
+namespace System\Tests\Console\Asset\Mix;
+
+use System\Classes\PluginManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Support\Facades\File;
+
+class MixCreateTest extends TestCase
+{
+    protected string $testPlugin = 'Winter.Sample';
+
+    public function testConfigWritten(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->doesntExpectOutput('winter.mix.js already exists, overwrite?')
+            ->assertExitCode(0);
+
+        // Validate the manifest was written
+        $this->assertFileExists($configPath);
+
+        // Get the predicted contents
+        $fixture = str_replace(
+            '{{packageName}}',
+            'winter-sample',
+            File::get(base_path('modules/system/console/asset/fixtures/config/mix/winter.mix.js.fixture')),
+        );
+
+        // Check the file written is what was expected
+        $this->assertEquals($fixture, File::get($configPath));
+
+        // Overwrite the file content
+        File::put($configPath, 'testing');
+
+        // Check that refusing to overwrite does not replace file contents
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->expectsQuestion('winter.mix.js already exists, overwrite?', false)
+            ->assertExitCode(0);
+
+        // Check file contents was not overwritten
+        $this->assertNotEquals($fixture, File::get($configPath));
+
+        // Run command confirming to overwrite file contents works
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->expectsQuestion('winter.mix.js already exists, overwrite?', true)
+            ->assertExitCode(0);
+
+        // Check file contents was overwritten
+        $this->assertEquals($fixture, File::get($configPath));
+    }
+
+    public function testConfigTailwind(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwindcss is required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+    }
+
+    public function testConfigReact(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with react
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--react' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check react is required
+        $this->assertTrue(isset($json->devDependencies->react));
+    }
+
+    public function testConfigTailwindReact(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with react
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--react' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwind & react are required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+        $this->assertTrue(isset($json->devDependencies->react));
+    }
+
+    public function testConfigVue(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with vue
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--vue' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check vue is required
+        $this->assertTrue(isset($json->devDependencies->vue));
+    }
+
+    public function testConfigTailwindVue(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/winter.mix.js';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with vue
+        $this->artisan('mix:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--vue' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwind & vue are required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+        $this->assertTrue(isset($json->devDependencies->vue));
+    }
+
+    public function tearDown(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+
+        $files = [
+            $path . '/winter.mix.js',
+            $path . '/package.json',
+            $path . '/tailwind.config.js',
+            $path . '/postcss.config.mjs',
+        ];
+
+        foreach ($files as $file) {
+            if (File::exists($file)) {
+                File::delete($file);
+            }
+        }
+    }
+}

modules/system/tests/console/asset/mix/MixInstallTest.php

@@ -0,0 +1,213 @@
+<?php
+
+namespace System\Tests\Console\Asset\Mix;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Exception\SystemException;
+use Winter\Storm\Support\Facades\File;
+
+class MixInstallTest extends TestCase
+{
+    protected string $fixturePath;
+    protected string $jsonPath;
+    protected string $lockPath;
+    protected string $backupPath;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        // Define some helpful paths
+        $this->fixturePath = base_path('modules/system/tests');
+        $this->jsonPath = $this->fixturePath . '/package.json';
+        $this->lockPath = $this->fixturePath . '/package-lock.json';
+        $this->backupPath = $this->fixturePath . '/package-testing.json';
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-assettest',
+            base_path('modules/system/tests/fixtures/themes/assettest/winter.mix.js'),
+            'mix'
+        );
+        PackageManager::instance()->registerPackage(
+            'theme-npmtest',
+            base_path('modules/system/tests/fixtures/themes/npmtest/winter.mix.js'),
+            'mix'
+        );
+    }
+
+    public function testMixInstallMissingPackageJson(): void
+    {
+        $this->artisan('mix:install', [
+            'assetPackage' => ['theme-assettest'],
+            '--package-json' => '/some/file',
+            '--no-install' => true
+        ])
+            ->expectsOutputToContain('The supplied --package-json path does not exist.')
+            ->assertExitCode(1);
+    }
+
+    public function testMixInstallSinglePackage(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('laravel-mix was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('laravel-mix', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+        });
+    }
+
+    public function testMixInstallMultiplePackages(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest', 'theme-npmtest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('laravel-mix was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->expectsOutput('Adding theme-npmtest (modules/system/tests/fixtures/themes/npmtest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('laravel-mix', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+            $this->assertContains('modules/system/tests/fixtures/themes/npmtest', $packageJson['workspaces']['packages']);
+        });
+    }
+
+    public function testMixInstallMissingPackage(): void
+    {
+        // We should receive an exception for a missing package
+        $this->withPackageJsonRestore(function () {
+            $this->expectException(SystemException::class);
+
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest2'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->assertExitCode(1);
+        });
+    }
+
+    public function testMixInstallRelativePath(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => 'modules/system/tests/package.json',
+                '--no-install' => true
+            ])
+                ->expectsQuestion('laravel-mix was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+        });
+    }
+
+    public function testMixInstallIgnoredPackage(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $packageJson['workspaces'] = [
+                'ignoredPackages' => [
+                    'modules/system/tests/fixtures/themes/assettest'
+                ]
+            ];
+            File::put($this->jsonPath, json_encode($packageJson, JSON_PRETTY_PRINT));
+
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('laravel-mix was not found as a dependency in package.json, would you like to add it?', false)
+                ->expectsOutput('The requested package theme-assettest (modules/system/tests/fixtures/themes/assettest) is ignored, remove it from package.json to continue.')
+                ->assertExitCode(0);
+
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayNotHasKey('packages', $packageJson['workspaces']);
+            $this->assertArrayNotHasKey('dependencies', $packageJson);
+            $this->assertArrayNotHasKey('devDependencies', $packageJson);
+        });
+    }
+
+    public function testMixInstallWithNpmInstall(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->assertDirectoryDoesNotExist($this->fixturePath . '/node_modules');
+
+            $this->artisan('mix:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--disable-tty' => true
+            ])
+                ->expectsQuestion('laravel-mix was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->expectsOutputToContain('packages, and audited') // output from npm i
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('laravel-mix', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+
+            $this->assertFileExists($this->lockPath);
+
+            $this->assertDirectoryExists($this->fixturePath . '/node_modules');
+            $this->assertDirectoryExists($this->fixturePath . '/node_modules/laravel-mix');
+        });
+    }
+
+    /**
+     * Helper to run test logic and handle restoring package.json file after
+     */
+    protected function withPackageJsonRestore(callable $callback): void
+    {
+        File::copy($this->backupPath, $this->jsonPath);
+        $callback();
+        File::delete($this->jsonPath);
+    }
+
+    public function tearDown(): void
+    {
+        if (File::isDirectory($this->fixturePath . '/node_modules')) {
+            File::deleteDirectory($this->fixturePath . '/node_modules');
+        }
+
+        if (File::exists($this->lockPath)) {
+            File::delete($this->lockPath);
+        }
+
+        parent::tearDown();
+    }
+}

modules/system/tests/console/asset/npm/NpmInstallTest.php

@@ -0,0 +1,209 @@
+<?php
+
+namespace System\Tests\Console\Asset\Npm;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use System\Tests\Console\Asset\NpmTestTrait;
+use Winter\Storm\Support\Facades\File;
+
+class NpmInstallTest extends TestCase
+{
+    use NpmTestTrait;
+
+    protected string $themePath;
+    protected string $jsonPath;
+    protected string $lockPath;
+    protected string $backupPath;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        // Define some helpful paths
+        $this->themePath = base_path('modules/system/tests/fixtures/themes/npmtest');
+        $this->jsonPath = $this->themePath . '/package.json';
+        $this->lockPath = $this->themePath . '/package-lock.json';
+        $this->backupPath = $this->themePath . '/package.backup.json';
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-npmtest',
+            $this->themePath . '/vite.config.mjs',
+            'vite'
+        );
+    }
+
+    /**
+     * Test the ability to install a single npm package via artisan
+     */
+    public function testNpmInstallSingle(): void
+    {
+        // Validate the package Json does not have dependencies
+        $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+        $this->assertArrayNotHasKey('dependencies', $packageJson);
+
+        // Validate node_modules not found
+        $this->assertDirectoryDoesNotExist($this->themePath . '/node_modules');
+        $this->assertFileNotExists($this->lockPath);
+
+        $this->withPackageJsonRestore(function () {
+            // Run npm install for a single non-dev package
+            $this->artisan('npm:install', [
+                'package' => 'theme-npmtest',
+                'npmArgs' => ['is-odd'],
+                '--disable-tty' => true
+            ])
+                ->assertExitCode(0);
+
+            // Validate lock file was generated successfully
+            $this->assertFileExists($this->lockPath);
+
+            // Validate the contents of package.json
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('dependencies', $packageJson);
+            $this->assertArrayHasKey('is-odd', $packageJson['dependencies']);
+
+            // Validate that node_modules paths exist
+            $this->assertDirectoryExists($this->themePath . '/node_modules');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-odd');
+        });
+    }
+
+    /**
+     * Test the ability to install multiple npm packages via artisan
+     */
+    public function testNpmInstallMultiple(): void
+    {
+        // Validate the package Json does not have dependencies
+        $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+        $this->assertArrayNotHasKey('dependencies', $packageJson);
+
+        // Validate node_modules not found
+        $this->assertDirectoryDoesNotExist($this->themePath . '/node_modules');
+        $this->assertFileNotExists($this->lockPath);
+
+        $this->withPackageJsonRestore(function () {
+            // Run npm install for multiple non-dev packages
+            $this->artisan('npm:install', [
+                'package' => 'theme-npmtest',
+                'npmArgs' => ['is-odd', 'is-even'],
+                '--disable-tty' => true
+            ])
+                ->assertExitCode(0);
+
+            // Validate lock file was generated successfully
+            $this->assertFileExists($this->lockPath);
+
+            // Validate the contents of package.json
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('dependencies', $packageJson);
+            $this->assertArrayHasKey('is-odd', $packageJson['dependencies']);
+            $this->assertArrayHasKey('is-even', $packageJson['dependencies']);
+
+            // Validate that node_modules paths exist
+            $this->assertDirectoryExists($this->themePath . '/node_modules');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-odd');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-even');
+        });
+    }
+
+
+    /**
+     * Test the ability to install a single dev npm package via artisan
+     */
+    public function testNpmInstallSingleDev(): void
+    {
+        // Validate the package Json does not have dependencies
+        $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+        $this->assertArrayNotHasKey('devDependencies', $packageJson);
+
+        // Validate node_modules not found
+        $this->assertDirectoryDoesNotExist($this->themePath . '/node_modules');
+        $this->assertFileNotExists($this->lockPath);
+
+        $this->withPackageJsonRestore(function () {
+            // Run npm install for a single dev package
+            $this->artisan('npm:install', [
+                'package' => 'theme-npmtest',
+                'npmArgs' => ['is-odd'],
+                '--dev' => true,
+                '--disable-tty' => true
+            ])
+                ->assertExitCode(0);
+
+            // Validate lock file was generated successfully
+            $this->assertFileExists($this->lockPath);
+
+            // Validate the contents of package.json
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('is-odd', $packageJson['devDependencies']);
+
+            // Validate that node_modules paths exist
+            $this->assertDirectoryExists($this->themePath . '/node_modules');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-odd');
+        });
+    }
+
+    /**
+     * Test the ability to install multiple dev npm packages via artisan
+     */
+    public function testNpmInstallMultipleDev(): void
+    {
+        // Validate the package Json does not have dependencies
+        $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+        $this->assertArrayNotHasKey('devDependencies', $packageJson);
+
+        // Validate node_modules not found
+        $this->assertDirectoryDoesNotExist($this->themePath . '/node_modules');
+        $this->assertFileNotExists($this->lockPath);
+
+        $this->withPackageJsonRestore(function () {
+            // Run npm install for multiple dev packages
+            $this->artisan('npm:install', [
+                'package' => 'theme-npmtest',
+                'npmArgs' => ['is-odd', 'is-even'],
+                '--dev' => true,
+                '--disable-tty' => true
+            ])
+                ->assertExitCode(0);
+
+            // Validate lock file was generated successfully
+            $this->assertFileExists($this->lockPath);
+
+            // Validate the contents of package.json
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('is-odd', $packageJson['devDependencies']);
+            $this->assertArrayHasKey('is-even', $packageJson['devDependencies']);
+
+            // Validate that node_modules paths exist
+            $this->assertDirectoryExists($this->themePath . '/node_modules');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-odd');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-even');
+        });
+    }
+
+    /**
+     * Cleanup the test theme
+     */
+    public function tearDown(): void
+    {
+        if (File::isDirectory($this->themePath . '/node_modules')) {
+            File::deleteDirectory($this->themePath . '/node_modules');
+        }
+
+        foreach ([$this->backupPath, $this->lockPath] as $path) {
+            if (File::exists($path)) {
+                File::delete($path);
+            }
+        }
+
+        parent::tearDown();
+    }
+}

modules/system/tests/console/asset/npm/NpmRunTest.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace System\Tests\Console\Asset\Npm;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Support\Facades\File;
+
+class NpmRunTest extends TestCase
+{
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-npmtest',
+            base_path('modules/system/tests/fixtures/themes/npmtest/vite.config.mjs'),
+            'vite'
+        );
+    }
+
+    /**
+     * Test the ability to run a npm script via artisan
+     */
+    public function testNpmRunScript(): void
+    {
+        $this->artisan('npm:run', [
+            'package' => 'theme-npmtest',
+            'script' => 'testScript',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('> echo "Winter says $((1+2))"')
+            ->expectsOutputToContain('Winter says 3')
+            ->assertExitCode(0);
+    }
+
+    /**
+     * Test the error handling of a missing script
+     */
+    public function testNpmRunScriptFailed(): void
+    {
+        $this->artisan('npm:run', [
+            'package' => 'theme-npmtest',
+            'script' => 'testMissingScript',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('Script "testMissingScript" is not defined in package "theme-npmtest"')
+            ->assertExitCode(1);
+    }
+}

modules/system/tests/console/asset/npm/NpmUpdateTest.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace System\tests\console\asset\npm;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use System\Tests\Console\Asset\NpmTestTrait;
+use Winter\Storm\Support\Facades\File;
+
+class NpmUpdateTest extends TestCase
+{
+    use NpmTestTrait;
+
+    protected string $themePath;
+    protected string $jsonPath;
+    protected string $lockPath;
+    protected string $backupPath;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        // Define some helpful paths
+        $this->themePath = base_path('modules/system/tests/fixtures/themes/npmtest');
+        $this->jsonPath = $this->themePath . '/package.json';
+        $this->lockPath = $this->themePath . '/package-lock.json';
+        $this->backupPath = $this->themePath . '/package.backup.json';
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-npmtest',
+            $this->themePath . '/vite.config.mjs',
+            'vite'
+        );
+    }
+
+    /**
+     * Test the ability to install a single npm package via artisan
+     */
+    public function testNpmUpdate(): void
+    {
+        // Validate the package Json does not have dependencies
+        $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+        $this->assertArrayNotHasKey('dependencies', $packageJson);
+
+        // Validate node_modules not found
+        $this->assertDirectoryDoesNotExist($this->themePath . '/node_modules');
+        $this->assertFileNotExists($this->lockPath);
+
+        $this->withPackageJsonRestore(function () {
+            // Update the contents of package.json to include a package at an old patch
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $packageJson['dependencies'] = [
+                'is-odd' => '^3.0.0'
+            ];
+            File::put($this->jsonPath, json_encode($packageJson, JSON_PRETTY_PRINT));
+
+            // Run npm update
+            $this->artisan('npm:update', [
+                'package' => 'theme-npmtest',
+                '--save' => true,
+                '--disable-tty' => true
+            ])
+                ->assertExitCode(0);
+
+            // Validate lock file was generated successfully
+            $this->assertFileExists($this->lockPath);
+
+            // Get the new contents of package.json
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+
+            // Validate that the package.json contents does not match the old patch value we added above
+            $this->assertArrayHasKey('dependencies', $packageJson);
+            $this->assertArrayHasKey('is-odd', $packageJson['dependencies']);
+            $this->assertNotEquals('^3.0.0', $packageJson['dependencies']['is-odd']);
+
+            // Validate that node_modules paths exist
+            $this->assertDirectoryExists($this->themePath . '/node_modules');
+            $this->assertDirectoryExists($this->themePath . '/node_modules/is-odd');
+        });
+    }
+
+    /**
+     * Cleanup the test theme
+     */
+    public function tearDown(): void
+    {
+        if (File::isDirectory($this->themePath . '/node_modules')) {
+            File::deleteDirectory($this->themePath . '/node_modules');
+        }
+
+        foreach ([$this->backupPath, $this->lockPath] as $path) {
+            if (File::exists($path)) {
+                File::delete($path);
+            }
+        }
+
+        parent::tearDown();
+    }
+}

modules/system/tests/console/asset/vite/ViteCompileTest.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace System\Tests\Console\Asset\Vite;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Support\Facades\File;
+
+class ViteCompileTest extends TestCase
+{
+    protected string $themePath;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        if (!File::exists(base_path('node_modules/.bin/vite'))) {
+            $this->markTestSkipped('This test requires the vite package to be installed');
+        }
+
+        $this->themePath = base_path('modules/system/tests/fixtures/themes/assettest');
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-assettest',
+            $this->themePath . '/vite.config.mjs',
+            'vite'
+        );
+    }
+
+    public function testThemeCompile(): void
+    {
+        // Run the vite:compile command
+        $this->artisan('vite:compile', [
+            'theme-assettest',
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-vitetheme.json',
+            '--silent' => true
+        ])->assertExitCode(0);
+
+        $manifestPath = $this->themePath . '/public/build/manifest.json';
+
+        // Validate the manifest was written
+        $this->assertFileExists($manifestPath);
+
+        // Get the contents of the manifest
+        $manifest = json_decode(File::get($manifestPath), JSON_OBJECT_AS_ARRAY);
+
+        // Validate the css was compiled correctly
+        $this->assertArrayHasKey('assets/css/theme.css', $manifest);
+        $this->assertFileExists($this->themePath . '/public/build/' . $manifest['assets/css/theme.css']['file']);
+        $this->assertEquals(
+            'h1{color:red}',
+            trim(File::get($this->themePath . '/public/build/' . $manifest['assets/css/theme.css']['file']))
+        );
+
+        // Validate the js was compiled correctly
+        $this->assertArrayHasKey('assets/javascript/theme.js', $manifest);
+        $this->assertFileExists($this->themePath . '/public/build/' . $manifest['assets/javascript/theme.js']['file']);
+        $this->assertEquals(
+            'window.alert("hello world");',
+            trim(File::get($this->themePath . '/public/build/' . $manifest['assets/javascript/theme.js']['file']))
+        );
+    }
+
+    public function testThemeCompileFailed(): void
+    {
+        // Rename the css file so vite cannot find it
+        File::move($this->themePath . '/assets/css/theme.css', $this->themePath . '/assets/css/theme.back');
+
+        // Run the vite:compile command
+        $this->artisan('vite:compile', [
+            'theme-assettest',
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-vitetheme.json',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('Could not resolve entry module "assets/css/theme.css".')
+            ->assertExitCode(1);
+
+        // Validate the manifest was not written
+        $this->assertFileNotExists($this->themePath . '/public/build/manifest.json');
+
+        // Put the css file back
+        File::move($this->themePath . '/assets/css/theme.back', $this->themePath . '/assets/css/theme.css');
+    }
+
+    public function testThemeCompileWarning(): void
+    {
+        // Rename the css file so vite cannot find it
+        $contents = File::get($this->themePath . '/assets/css/theme.css');
+
+        File::put($this->themePath . '/assets/css/theme.css', 'h1 {color:');
+
+        // Run the vite:compile command
+        $this->artisan('vite:compile', [
+            'theme-assettest',
+            '--manifest' => 'modules/system/tests/fixtures/npm/package-vitetheme.json',
+            '--disable-tty' => true
+        ])
+            ->expectsOutputToContain('[WARNING] Expected "}" to go with "{" [css-syntax-error]')
+            ->assertExitCode(0);
+
+        // Validate the manifest was not written
+        $this->assertFileExists($this->themePath . '/public/build/manifest.json');
+
+        // Put the css file back
+        File::put($this->themePath . '/assets/css/theme.css', $contents);
+    }
+
+    public function tearDown(): void
+    {
+        File::deleteDirectory('modules/system/tests/fixtures/themes/assettest/public');
+        parent::tearDown();
+    }
+}

modules/system/tests/console/asset/vite/ViteCreateTest.php

@@ -0,0 +1,234 @@
+<?php
+
+namespace System\Tests\Console\Asset\Vite;
+
+use System\Classes\PluginManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Support\Facades\File;
+
+class ViteCreateTest extends TestCase
+{
+    protected string $testPlugin = 'Winter.Sample';
+
+    public function testConfigWritten(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->doesntExpectOutput('vite.config.mjs already exists, overwrite?')
+            ->assertExitCode(0);
+
+        // Validate the manifest was written
+        $this->assertFileExists($configPath);
+
+        // Get the predicted contents
+        $fixture = str_replace(
+            '{{packageName}}',
+            'winter-sample',
+            File::get(base_path('modules/system/console/asset/fixtures/config/vite/vite.config.mjs.fixture')),
+        );
+
+        // Check the file written is what was expected
+        $this->assertEquals($fixture, File::get($configPath));
+
+        // Overwrite the file content
+        File::put($configPath, 'testing');
+
+        // Check that refusing to overwrite does not replace file contents
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->expectsQuestion('vite.config.mjs already exists, overwrite?', false)
+            ->assertExitCode(0);
+
+        // Check file contents was not overwritten
+        $this->assertNotEquals($fixture, File::get($configPath));
+
+        // Run command confirming to overwrite file contents works
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--no-stubs' => true,
+        ])
+            ->expectsQuestion('vite.config.mjs already exists, overwrite?', true)
+            ->assertExitCode(0);
+
+        // Check file contents was overwritten
+        $this->assertEquals($fixture, File::get($configPath));
+    }
+
+    public function testConfigTailwind(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwindcss is required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+    }
+
+    public function testConfigReact(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with react
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--react' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check react is required
+        $this->assertTrue(isset($json->devDependencies->react));
+    }
+
+    public function testConfigTailwindReact(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with react
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--react' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwind & react are required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+        $this->assertTrue(isset($json->devDependencies->react));
+    }
+
+    public function testConfigVue(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with vue
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--vue' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check vue is required
+        $this->assertTrue(isset($json->devDependencies->vue));
+    }
+
+    public function testConfigTailwindVue(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+        $configPath = $path . '/vite.config.mjs';
+        $packageJson = $path . '/package.json';
+
+        // Check file does not exist
+        $this->assertFileNotExists($configPath);
+
+        // Run the config command to generate the vite config with vue
+        $this->artisan('vite:create', [
+            'packageName' => $this->testPlugin,
+            '--tailwind' => true,
+            '--vue' => true,
+            '--no-stubs' => true,
+        ])
+            ->assertExitCode(0);
+
+        // Check files are created correctly
+        $this->assertFileExists($configPath);
+        $this->assertFileExists($packageJson);
+        $this->assertFileExists($path . '/tailwind.config.js');
+        $this->assertFileExists($path . '/postcss.config.mjs');
+
+        // Get the contents of the package.json
+        $json = json_decode(File::get($packageJson));
+
+        // Check tailwind & vue are required
+        $this->assertTrue(isset($json->devDependencies->tailwindcss));
+        $this->assertTrue(isset($json->devDependencies->vue));
+    }
+
+    public function tearDown(): void
+    {
+        $path = PluginManager::instance()->findByIdentifier($this->testPlugin)->getPluginPath();
+
+        $files = [
+            $path . '/vite.config.mjs',
+            $path . '/package.json',
+            $path . '/tailwind.config.js',
+            $path . '/postcss.config.mjs',
+        ];
+
+        foreach ($files as $file) {
+            if (File::exists($file)) {
+                File::delete($file);
+            }
+        }
+    }
+}

modules/system/tests/console/asset/vite/ViteInstallTest.php

@@ -0,0 +1,223 @@
+<?php
+
+namespace System\Tests\Console\Asset\Vite;
+
+use System\Classes\Asset\PackageManager;
+use System\Tests\Bootstrap\TestCase;
+use Winter\Storm\Exception\SystemException;
+use Winter\Storm\Support\Facades\File;
+
+class ViteInstallTest extends TestCase
+{
+    protected string $jsonPath;
+    protected string $lockPath;
+    protected string $backupPath;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        if (!File::exists(base_path('node_modules'))) {
+            $this->markTestSkipped('This test requires node_modules to be installed');
+        }
+
+        // Define some helpful paths
+        $this->fixturePath = base_path('modules/system/tests');
+        $this->jsonPath = $this->fixturePath . '/package.json';
+        $this->lockPath = $this->fixturePath . '/package-lock.json';
+        $this->backupPath = $this->fixturePath . '/package-testing.json';
+
+        // Add our testing theme because it won't be auto discovered
+        PackageManager::instance()->registerPackage(
+            'theme-assettest',
+            base_path('modules/system/tests/fixtures/themes/assettest/vite.config.mjs'),
+            'vite'
+        );
+        PackageManager::instance()->registerPackage(
+            'theme-npmtest',
+            base_path('modules/system/tests/fixtures/themes/npmtest/vite.config.mjs'),
+            'vite'
+        );
+    }
+
+    public function testViteInstallMissingPackageJson(): void
+    {
+        $this->artisan('vite:install', [
+            'assetPackage' => ['theme-assettest'],
+            '--package-json' => '/some/file',
+            '--no-install' => true
+        ])
+            ->expectsOutputToContain('The supplied --package-json path does not exist.')
+            ->assertExitCode(1);
+    }
+
+    public function testViteInstallSinglePackage(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('vite was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsQuestion('laravel-vite-plugin was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('vite', $packageJson['devDependencies']);
+            $this->assertArrayHasKey('laravel-vite-plugin', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+        });
+    }
+
+    public function testViteInstallMultiplePackages(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest', 'theme-npmtest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('vite was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsQuestion('laravel-vite-plugin was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->expectsOutput('Adding theme-npmtest (modules/system/tests/fixtures/themes/npmtest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('vite', $packageJson['devDependencies']);
+            $this->assertArrayHasKey('laravel-vite-plugin', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+            $this->assertContains('modules/system/tests/fixtures/themes/npmtest', $packageJson['workspaces']['packages']);
+        });
+    }
+
+    public function testViteInstallMissingPackage(): void
+    {
+        // We should receive an exception for a missing package
+        $this->withPackageJsonRestore(function () {
+            $this->expectException(SystemException::class);
+            $this->expectExceptionMessage('PackageNotFoundException: The package `theme-assettest2` does not exist.');
+
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest2'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->assertExitCode(1);
+        });
+    }
+
+    public function testViteInstallRelativePath(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => 'modules/system/tests/package.json',
+                '--no-install' => true
+            ])
+                ->expectsQuestion('vite was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsQuestion('laravel-vite-plugin was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->assertExitCode(0);
+        });
+    }
+
+    public function testViteInstallIgnoredPackage(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $packageJson['workspaces'] = [
+                'ignoredPackages' => [
+                    'modules/system/tests/fixtures/themes/assettest'
+                ]
+            ];
+
+            File::put($this->jsonPath, json_encode($packageJson, JSON_PRETTY_PRINT));
+
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--no-install' => true
+            ])
+                ->expectsQuestion('vite was not found as a dependency in package.json, would you like to add it?', false)
+                ->expectsQuestion('laravel-vite-plugin was not found as a dependency in package.json, would you like to add it?', false)
+                ->expectsOutput('The requested package theme-assettest (modules/system/tests/fixtures/themes/assettest) is ignored, remove it from package.json to continue.')
+                ->assertExitCode(0);
+
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayNotHasKey('packages', $packageJson['workspaces']);
+            $this->assertArrayNotHasKey('dependencies', $packageJson);
+            $this->assertArrayNotHasKey('devDependencies', $packageJson);
+        });
+    }
+
+    public function testViteInstallWithNpmInstall(): void
+    {
+        $this->withPackageJsonRestore(function () {
+            $this->assertDirectoryDoesNotExist($this->fixturePath . '/node_modules');
+
+            $this->artisan('vite:install', [
+                'assetPackage' => ['theme-assettest'],
+                '--package-json' => $this->jsonPath,
+                '--disable-tty' => true
+            ])
+                ->expectsQuestion('vite was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsQuestion('laravel-vite-plugin was not found as a dependency in package.json, would you like to add it?', true)
+                ->expectsOutput('Adding theme-assettest (modules/system/tests/fixtures/themes/assettest) to the workspaces.packages property in package.json')
+                ->expectsOutputToContain('packages, and audited') // output from npm i
+                ->assertExitCode(0);
+
+            $this->assertFileExists($this->jsonPath);
+            $packageJson = json_decode(File::get($this->jsonPath), JSON_OBJECT_AS_ARRAY);
+            $this->assertArrayHasKey('devDependencies', $packageJson);
+            $this->assertArrayHasKey('vite', $packageJson['devDependencies']);
+            $this->assertArrayHasKey('laravel-vite-plugin', $packageJson['devDependencies']);
+
+            $this->assertArrayHasKey('workspaces', $packageJson);
+            $this->assertArrayHasKey('packages', $packageJson['workspaces']);
+            $this->assertContains('modules/system/tests/fixtures/themes/assettest', $packageJson['workspaces']['packages']);
+
+            $this->assertFileExists($this->lockPath);
+
+            $this->assertDirectoryExists($this->fixturePath . '/node_modules');
+            $this->assertDirectoryExists($this->fixturePath . '/node_modules/vite');
+            $this->assertDirectoryExists($this->fixturePath . '/node_modules/laravel-vite-plugin');
+        });
+    }
+
+    /**
+     * Helper to run test logic and handle restoring package.json file after
+     */
+    protected function withPackageJsonRestore(callable $callback): void
+    {
+        File::copy($this->backupPath, $this->jsonPath);
+        $callback();
+        File::delete($this->jsonPath);
+    }
+
+    public function tearDown(): void
+    {
+        if (File::isDirectory($this->fixturePath . '/node_modules')) {
+            File::deleteDirectory($this->fixturePath . '/node_modules');
+        }
+
+        if (File::exists($this->lockPath)) {
+            File::delete($this->lockPath);
+        }
+
+        parent::tearDown();
+    }
+}