feat: add option to set cssPath to false (#544)

Co-authored-by: Younho Choo <yo+github@younho9.com>
Co-authored-by: Sébastien Chopin <seb@nuxtlabs.com>

docs/content/1.getting-started/2.options.md

@@ -33,6 +33,20 @@ export default {
 
 This file will be directly injected as a [global CSS](https://v3.nuxtjs.org/api/configuration/nuxt.config#css) for Nuxt. It supports `css`, `sass`, `postcss`, and more.
 
+If you don't want to inject CSS file, you can set `cssPath` to `false`.
+
+```ts [nuxt.config]
+export default {
+  tailwindcss: {
+    cssPath: false,
+  }
+}
+```
+
+::alert{type="warning"}
+When set to `false`, note that HMR for tailwindcss will be broken (hard refresh needed).
+::
+
 ## `configPath`
 
 - Default: `'tailwind.config'`

src/module.ts

@@ -43,7 +43,7 @@ type Arrayable<T> = T | T[]
 
 export interface ModuleOptions {
   configPath: Arrayable<string>;
-  cssPath: string;
+  cssPath: string | false;
   config: Config;
   viewer: boolean;
   exposeConfig: boolean;
@@ -170,7 +170,7 @@ export default defineNuxtModule<ModuleOptions>({
      * CSS file handling
      */
 
-    const cssPath = await resolvePath(moduleOptions.cssPath, { extensions: ['.css', '.sass', '.scss', '.less', '.styl'] })
+    const cssPath = typeof moduleOptions.cssPath === 'string' ? await resolvePath(moduleOptions.cssPath, { extensions: ['.css', '.sass', '.scss', '.less', '.styl'] }) : false
 
     // Include CSS file in project css
     let resolvedCss: string
@@ -183,6 +183,9 @@ export default defineNuxtModule<ModuleOptions>({
         // @ts-ignore
         resolvedCss = createResolver(import.meta.url).resolve('runtime/tailwind.css')
       }
+    } else {
+      logger.info('No Tailwind CSS file found. Skipping...')
+      resolvedCss = createResolver(import.meta.url).resolve('runtime/empty.css')
     }
     nuxt.options.css = nuxt.options.css ?? []
     const resolvedNuxtCss = await Promise.all(nuxt.options.css.map(p => resolvePath(p)))