More extensive configuration documentation

Author: kevindierkx

config/blade-components.php

@@ -15,6 +15,8 @@
     | - Without: <x-btn></x-btn>
     | - With:    <x-df-btn></x-df-btn>
     |
+    | @see https://blade-components.com/docs/configuration#preventing-collisions
+    |
     */
 
     'prefix' => null,
@@ -27,6 +29,8 @@
     | All components, including their backing class, that should be
     | registered during runtime.
     |
+    | @see https://blade-components.com/docs/configuration#publishing-configuration
+    |
     */
 
     'components' => [

docs/10-installation.md

@@ -71,23 +71,3 @@ Blade Colors is automatically installed with Blade Components. After installatio
 #### Theme customization
 
 Blade Components implements the ["default theme"](https://github.com/distortedfusion/blade-colors/blob/master/src/Themes/DefaultTheme.php) offered by [Blade Colors](https://distortedfusion.com/docs/distortedfusion/blade-colors/getting-started). You can customize this to your liking, for a detailed explanation please refer to the [theming](/docs/theming) documentation.
-
-## Publishing Configuration
-
-You can publish the package configuration using the following command:
-
-```bash
-php artisan vendor:publish --tag=blade-components-config
-```
-
-Publishing the package configuration allows you to disable or add components.
-
-## Publishing Views
-
-You can publish the package views using the following command:
-
-```bash
-php artisan vendor:publish --tag=blade-components-views
-```
-
-After publishing you can modify the views from your application's `/resources/views/vendor/blade-components` directory.

docs/20-configuration.md

@@ -0,0 +1,55 @@
+---
+title: Configuration
+description: Exclude components trough configuration, prevent collisions, and customize components by publishing their views.
+---
+
+## Publishing configuration
+
+All components, and their aliases, offered by Blade Components are configured in the [`blade-components.php`](https://github.com/distortedfusion/blade-components/blob/master/config/blade-components.php) configuration file. You can exclude certain components by removing them from the `components` entry after publishing the configuration file.
+
+> [!NOTE]
+> It's possible to change the alias used by a component from the same configuration file. However, this isn't recommended as new components added in future releases might overlap.
+
+You can publish the package configuration using the following command:
+
+```bash
+php artisan vendor:publish --tag=blade-components-config
+```
+
+Publishing the package configuration allows you to disable or add components.
+
+### Preventing collisions
+
+To prevent collisions with your own components, it's possible to prefix all components offered by Blade Components with a prefix.
+
+After publishing the configuration file set the `prefix` entry to the prefix you would like to use.
+
+```php
+<?php
+
+return [
+
+    'prefix' => null,
+
+];
+```
+
+```html
+<!-- Without prefix, default behavior -->
+<x-btn>Button</x-btn>
+
+<!-- With a prefix set to `df` -->
+<x-df-btn>Button</x-df-btn>
+```
+
+## Publishing views
+
+If you would like to make more impactful modifications to a component, the recommended approach is to publish the components view file to your application.
+
+You can publish the packaged views using the following command:
+
+```bash
+php artisan vendor:publish --tag=blade-components-views
+```
+
+After publishing you can modify the views from your application's `/resources/views/vendor/blade-components` directory.

docs/20-components.md docs/30-components.mddocs/20-components.md renamed to docs/30-components.md

@@ -6,7 +6,7 @@ description: Every detail is built for speed and consistency, so you can create
 ```blade-component
     <x-docs.components-toc />
 ```
-## Form Components
+## Form components
 
 A collection of Blade form components designed to streamline the creation of user-friendly, accessible, and visually appealing forms in Laravel applications.
 

docs/30-forms.md docs/40-forms.mddocs/30-forms.md renamed to docs/40-forms.md

@@ -43,7 +43,7 @@ export default {
 
 Please refer to the [Tailwind CSS documentation](https://tailwindcss.com/docs/installation) if you don't have Tailwind CSS installed already.
 
-## Publishing Configuration
+## Publishing configuration
 
 You can publish the package configuration using the following command:
 
@@ -53,9 +53,9 @@ php artisan vendor:publish --tag=blade-forms-config
 
 Publishing the package configuration allows you to disable or add components.
 
-## Publishing Views
+## Publishing views
 
-You can publish the package views using the following command:
+You can publish the packaged views using the following command:
 
 ```bash
 php artisan vendor:publish --tag=blade-forms-views