appearance

docs/source/docs/forms.blade.md

@@ -37,3 +37,37 @@ Form controls are great candidates for component classes, but just for fun, here
   </div>
 </div>
 @endcomponent
+
+## Customizing
+
+### Responsive, Hover, and Focus Variants
+
+By default, no hover, focus, or group-hover variants are generated for form control appearance utilities.
+
+You can control which variants are generated for form control appearance utilities by modifying the `appearance` property in the `modules` section of your Tailwind config file.
+
+For example, this config will _also_ generate hover and focus variants:
+
+```js
+{
+    // ...
+    modules: {
+        // ...
+        appearance: ['responsive', 'hover', 'focus'],
+    }
+}
+```
+
+### Disabling
+
+If you aren't using the form control appearance utilities in your project, you can disable them entirely by setting the `appearance` property to `false` in the `modules` section of your config file:
+
+```js
+{
+    // ...
+    modules: {
+        // ...
+        appearance: false,
+    }
+}
+```