Windows Docker and Tailwind watch mode

doc/index.rst

@@ -54,6 +54,17 @@ That's it! This will watch for changes to your ``assets/styles/app.css`` file
 and automatically recompile it when needed. If you refresh the page, the
 final ``app.css`` file will already contain the compiled CSS.
 
+Watch mode in Docker with Windows host
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you work on Windows and your app is running in a Docker container, and you
+are having trouble with the ``--watch`` option, you can try runnig the ``tailwind:build``
+command with ``--poll-watch`` option.
+
+.. code-block:: terminal
+
+    $ php bin/console tailwind:build --poll-watch
+
 Symfony CLI
 ~~~~~~~~~~~
 

src/Command/TailwindBuildCommand.php

@@ -33,6 +33,7 @@ protected function configure(): void
     {
         $this
             ->addOption('watch', 'w', null, 'Watch for changes and rebuild automatically')
+            ->addOption('poll-watch', null, null, 'Watch for changes and rebuild automatically (with --poll flag)')
             ->addOption('minify', 'm', InputOption::VALUE_NONE, 'Minify the output CSS')
         ;
     }
@@ -44,6 +45,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $process = $this->tailwindBuilder->runBuild(
             watch: $input->getOption('watch'),
+            pollWatch: $input->getOption('poll-watch'),
             minify: $input->getOption('minify'),
         );
         $process->wait(function ($type, $buffer) use ($io) {

src/TailwindBuilder.php

@@ -48,18 +48,22 @@ public function __construct(
 
     public function runBuild(
         bool $watch,
+        bool $pollWatch,
         bool $minify,
     ): Process {
         $binary = $this->createBinary();
         $arguments = ['-c', $this->configPath, '-i', $this->inputPath, '-o', $this->getInternalOutputCssPath()];
         if ($watch) {
             $arguments[] = '--watch';
+        } elseif ($pollWatch) {
+            $arguments[] = '--watch';
+            $arguments[] = '--poll';
         }
         if ($minify) {
             $arguments[] = '--minify';
         }
         $process = $binary->createProcess($arguments);
-        if ($watch) {
+        if ($watch || $pollWatch) {
             $process->setTimeout(null);
             // setting an input stream causes the command to "wait" for the watch
             $inputStream = new InputStream();

tests/TailwindBuilderTest.php

@@ -46,7 +46,7 @@ public function testIntegrationWithDefaultOptions(): void
             null,
             __DIR__.'/fixtures/tailwind.config.js'
         );
-        $process = $builder->runBuild(watch: false, minify: false);
+        $process = $builder->runBuild(watch: false, pollWatch: false, minify: false);
         $process->wait();
 
         $this->assertTrue($process->isSuccessful());
@@ -67,7 +67,7 @@ public function testIntegrationWithMinify(): void
             null,
             __DIR__.'/fixtures/tailwind.config.js'
         );
-        $process = $builder->runBuild(watch: false, minify: true);
+        $process = $builder->runBuild(watch: false, pollWatch: false, minify: true);
         $process->wait();
 
         $this->assertTrue($process->isSuccessful());