From b6e1d8e1ca29c8598890193a4f5daedceaca5fdb Mon Sep 17 00:00:00 2001 From: Dan Harrin Date: Mon, 19 Aug 2024 12:50:43 +0100 Subject: [PATCH] rearrange to remove installation docs --- docs/09-upgrade-guide.md | 2 +- packages/actions/docs/01-installation.md | 174 ----------------- .../docs/{02-overview.md => 01-overview.md} | 0 ...trigger-button.md => 02-trigger-button.md} | 0 .../docs/{04-modals.md => 03-modals.md} | 0 ...ping-actions.md => 04-grouping-actions.md} | 0 ...ding-an-action-to-a-livewire-component.md} | 0 .../01-create.md | 0 .../02-edit.md | 0 .../03-view.md | 0 .../04-delete.md | 0 .../05-replicate.md | 0 .../06-force-delete.md | 0 .../07-restore.md | 0 .../08-import.md | 0 .../09-export.md | 0 .../docs/{08-advanced.md => 07-advanced.md} | 0 .../docs/{09-testing.md => 08-testing.md} | 0 ...tting-started.md => 01-getting-started.md} | 0 packages/forms/docs/01-installation.md | 176 ------------------ .../{03-fields => 02-fields}/01-overview.md | 0 .../{03-fields => 02-fields}/02-text-input.md | 0 .../{03-fields => 02-fields}/03-select.md | 0 .../{03-fields => 02-fields}/04-checkbox.md | 0 .../{03-fields => 02-fields}/05-toggle.md | 0 .../06-checkbox-list.md | 0 .../docs/{03-fields => 02-fields}/07-radio.md | 0 .../08-date-time-picker.md | 0 .../09-file-upload.md | 0 .../10-rich-editor.md | 0 .../11-markdown-editor.md | 0 .../{03-fields => 02-fields}/12-repeater.md | 0 .../{03-fields => 02-fields}/13-builder.md | 0 .../{03-fields => 02-fields}/14-tags-input.md | 0 .../{03-fields => 02-fields}/15-textarea.md | 0 .../{03-fields => 02-fields}/16-key-value.md | 0 .../17-color-picker.md | 0 .../18-toggle-buttons.md | 0 .../{03-fields => 02-fields}/19-hidden.md | 0 .../{03-fields => 02-fields}/20-custom.md | 0 ...-adding-a-form-to-a-livewire-component.md} | 0 .../{05-validation.md => 04-validation.md} | 0 .../docs/{07-advanced.md => 05-advanced.md} | 0 .../docs/{08-testing.md => 06-testing.md} | 0 ...tting-started.md => 01-getting-started.md} | 0 packages/infolists/docs/01-installation.md | 174 ----------------- .../{03-entries => 02-entries}/01-overview.md | 0 .../{03-entries => 02-entries}/02-text.md | 0 .../{03-entries => 02-entries}/03-icon.md | 0 .../{03-entries => 02-entries}/04-image.md | 0 .../{03-entries => 02-entries}/05-color.md | 0 .../06-key-value.md | 0 .../07-repeatable.md | 0 .../{03-entries => 02-entries}/08-custom.md | 0 ...ng-an-infolist-to-a-livewire-component.md} | 0 .../docs/{05-advanced.md => 04-advanced.md} | 0 .../docs/{06-testing.md => 05-testing.md} | 0 .../notifications/docs/01-installation.md | 176 ------------------ ...cations.md => 01-sending-notifications.md} | 0 ...ations.md => 02-database-notifications.md} | 0 ...tions.md => 03-broadcast-notifications.md} | 0 ...ons.md => 04-customizing-notifications.md} | 0 .../docs/{06-testing.md => 05-testing.md} | 0 ...tting-started.md => 01-getting-started.md} | 0 packages/panels/docs/01-installation.md | 166 ----------------- .../01-overview.md | 0 .../02-listing-records.md | 0 .../03-creating-records.md | 0 .../04-editing-records.md | 0 .../05-viewing-records.md | 0 .../06-deleting-records.md | 0 .../07-relation-managers.md | 0 .../08-global-search.md | 0 .../09-widgets.md | 0 .../10-custom-pages.md | 0 .../11-security.md | 0 .../panels/docs/{04-pages.md => 03-pages.md} | 0 .../docs/{05-dashboard.md => 04-dashboard.md} | 0 .../{06-navigation.md => 05-navigation.md} | 0 ...7-notifications.md => 06-notifications.md} | 0 .../panels/docs/{08-users.md => 07-users.md} | 0 ...9-configuration.md => 08-configuration.md} | 0 .../docs/{10-clusters.md => 09-clusters.md} | 0 .../docs/{11-tenancy.md => 10-tenancy.md} | 0 .../docs/{12-themes.md => 11-themes.md} | 0 .../docs/{13-plugins.md => 12-plugins.md} | 0 .../docs/{14-testing.md => 13-testing.md} | 0 ...tting-started.md => 01-getting-started.md} | 0 packages/tables/docs/01-installation.md | 176 ------------------ .../{03-columns => 02-columns}/01-overview.md | 0 .../{03-columns => 02-columns}/02-text.md | 0 .../{03-columns => 02-columns}/03-icon.md | 0 .../{03-columns => 02-columns}/04-image.md | 0 .../{03-columns => 02-columns}/05-color.md | 0 .../{03-columns => 02-columns}/06-select.md | 0 .../{03-columns => 02-columns}/07-toggle.md | 0 .../08-text-input.md | 0 .../{03-columns => 02-columns}/09-checkbox.md | 0 .../{03-columns => 02-columns}/10-custom.md | 0 .../11-relationships.md | 0 .../{03-columns => 02-columns}/12-advanced.md | 0 .../{04-filters => 03-filters}/01-overview.md | 0 .../{04-filters => 03-filters}/02-select.md | 0 .../{04-filters => 03-filters}/03-ternary.md | 0 .../04-query-builder.md | 0 .../{04-filters => 03-filters}/05-custom.md | 0 .../{04-filters => 03-filters}/06-layout.md | 0 .../docs/{05-actions.md => 04-actions.md} | 0 .../docs/{06-layout.md => 05-layout.md} | 0 .../docs/{07-summaries.md => 06-summaries.md} | 0 .../docs/{08-grouping.md => 07-grouping.md} | 0 .../{09-empty-state.md => 08-empty-state.md} | 0 .../docs/{10-advanced.md => 09-advanced.md} | 0 ...adding-a-table-to-a-livewire-component.md} | 0 .../docs/{12-testing.md => 11-testing.md} | 0 packages/upgrade/bin/filament-v4 | 2 +- packages/widgets/docs/01-installation.md | 174 ----------------- ...stats-overview.md => 01-stats-overview.md} | 0 .../docs/{03-charts.md => 02-charts.md} | 0 .../docs/{04-tables.md => 03-tables.md} | 0 ... => 04-adding-a-widget-to-a-blade-view.md} | 0 121 files changed, 2 insertions(+), 1218 deletions(-) delete mode 100644 packages/actions/docs/01-installation.md rename packages/actions/docs/{02-overview.md => 01-overview.md} (100%) rename packages/actions/docs/{03-trigger-button.md => 02-trigger-button.md} (100%) rename packages/actions/docs/{04-modals.md => 03-modals.md} (100%) rename packages/actions/docs/{05-grouping-actions.md => 04-grouping-actions.md} (100%) rename packages/actions/docs/{06-adding-an-action-to-a-livewire-component.md => 05-adding-an-action-to-a-livewire-component.md} (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/01-create.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/02-edit.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/03-view.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/04-delete.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/05-replicate.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/06-force-delete.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/07-restore.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/08-import.md (100%) rename packages/actions/docs/{07-prebuilt-actions => 06-prebuilt-actions}/09-export.md (100%) rename packages/actions/docs/{08-advanced.md => 07-advanced.md} (100%) rename packages/actions/docs/{09-testing.md => 08-testing.md} (100%) rename packages/forms/docs/{02-getting-started.md => 01-getting-started.md} (100%) delete mode 100644 packages/forms/docs/01-installation.md rename packages/forms/docs/{03-fields => 02-fields}/01-overview.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/02-text-input.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/03-select.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/04-checkbox.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/05-toggle.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/06-checkbox-list.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/07-radio.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/08-date-time-picker.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/09-file-upload.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/10-rich-editor.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/11-markdown-editor.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/12-repeater.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/13-builder.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/14-tags-input.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/15-textarea.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/16-key-value.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/17-color-picker.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/18-toggle-buttons.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/19-hidden.md (100%) rename packages/forms/docs/{03-fields => 02-fields}/20-custom.md (100%) rename packages/forms/docs/{04-adding-a-form-to-a-livewire-component.md => 03-adding-a-form-to-a-livewire-component.md} (100%) rename packages/forms/docs/{05-validation.md => 04-validation.md} (100%) rename packages/forms/docs/{07-advanced.md => 05-advanced.md} (100%) rename packages/forms/docs/{08-testing.md => 06-testing.md} (100%) rename packages/infolists/docs/{02-getting-started.md => 01-getting-started.md} (100%) delete mode 100644 packages/infolists/docs/01-installation.md rename packages/infolists/docs/{03-entries => 02-entries}/01-overview.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/02-text.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/03-icon.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/04-image.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/05-color.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/06-key-value.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/07-repeatable.md (100%) rename packages/infolists/docs/{03-entries => 02-entries}/08-custom.md (100%) rename packages/infolists/docs/{04-adding-an-infolist-to-a-livewire-component.md => 03-adding-an-infolist-to-a-livewire-component.md} (100%) rename packages/infolists/docs/{05-advanced.md => 04-advanced.md} (100%) rename packages/infolists/docs/{06-testing.md => 05-testing.md} (100%) delete mode 100644 packages/notifications/docs/01-installation.md rename packages/notifications/docs/{02-sending-notifications.md => 01-sending-notifications.md} (100%) rename packages/notifications/docs/{03-database-notifications.md => 02-database-notifications.md} (100%) rename packages/notifications/docs/{04-broadcast-notifications.md => 03-broadcast-notifications.md} (100%) rename packages/notifications/docs/{05-customizing-notifications.md => 04-customizing-notifications.md} (100%) rename packages/notifications/docs/{06-testing.md => 05-testing.md} (100%) rename packages/panels/docs/{02-getting-started.md => 01-getting-started.md} (100%) delete mode 100644 packages/panels/docs/01-installation.md rename packages/panels/docs/{03-resources => 02-resources}/01-overview.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/02-listing-records.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/03-creating-records.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/04-editing-records.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/05-viewing-records.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/06-deleting-records.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/07-relation-managers.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/08-global-search.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/09-widgets.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/10-custom-pages.md (100%) rename packages/panels/docs/{03-resources => 02-resources}/11-security.md (100%) rename packages/panels/docs/{04-pages.md => 03-pages.md} (100%) rename packages/panels/docs/{05-dashboard.md => 04-dashboard.md} (100%) rename packages/panels/docs/{06-navigation.md => 05-navigation.md} (100%) rename packages/panels/docs/{07-notifications.md => 06-notifications.md} (100%) rename packages/panels/docs/{08-users.md => 07-users.md} (100%) rename packages/panels/docs/{09-configuration.md => 08-configuration.md} (100%) rename packages/panels/docs/{10-clusters.md => 09-clusters.md} (100%) rename packages/panels/docs/{11-tenancy.md => 10-tenancy.md} (100%) rename packages/panels/docs/{12-themes.md => 11-themes.md} (100%) rename packages/panels/docs/{13-plugins.md => 12-plugins.md} (100%) rename packages/panels/docs/{14-testing.md => 13-testing.md} (100%) rename packages/tables/docs/{02-getting-started.md => 01-getting-started.md} (100%) delete mode 100644 packages/tables/docs/01-installation.md rename packages/tables/docs/{03-columns => 02-columns}/01-overview.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/02-text.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/03-icon.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/04-image.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/05-color.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/06-select.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/07-toggle.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/08-text-input.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/09-checkbox.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/10-custom.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/11-relationships.md (100%) rename packages/tables/docs/{03-columns => 02-columns}/12-advanced.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/01-overview.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/02-select.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/03-ternary.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/04-query-builder.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/05-custom.md (100%) rename packages/tables/docs/{04-filters => 03-filters}/06-layout.md (100%) rename packages/tables/docs/{05-actions.md => 04-actions.md} (100%) rename packages/tables/docs/{06-layout.md => 05-layout.md} (100%) rename packages/tables/docs/{07-summaries.md => 06-summaries.md} (100%) rename packages/tables/docs/{08-grouping.md => 07-grouping.md} (100%) rename packages/tables/docs/{09-empty-state.md => 08-empty-state.md} (100%) rename packages/tables/docs/{10-advanced.md => 09-advanced.md} (100%) rename packages/tables/docs/{11-adding-a-table-to-a-livewire-component.md => 10-adding-a-table-to-a-livewire-component.md} (100%) rename packages/tables/docs/{12-testing.md => 11-testing.md} (100%) delete mode 100644 packages/widgets/docs/01-installation.md rename packages/widgets/docs/{02-stats-overview.md => 01-stats-overview.md} (100%) rename packages/widgets/docs/{03-charts.md => 02-charts.md} (100%) rename packages/widgets/docs/{04-tables.md => 03-tables.md} (100%) rename packages/widgets/docs/{05-adding-a-widget-to-a-blade-view.md => 04-adding-a-widget-to-a-blade-view.md} (100%) diff --git a/docs/09-upgrade-guide.md b/docs/09-upgrade-guide.md index 5874c0f366..9135ba67bc 100644 --- a/docs/09-upgrade-guide.md +++ b/docs/09-upgrade-guide.md @@ -336,7 +336,7 @@ In v3, the `Illuminate\Auth\Events\Login` event was fired from the import and ex -The European Portuguese translations +European Portuguese translations The European Portuguese translations have been moved from `pt_PT` to `pt`, which appears to be the more commonly used language code for the language within the Laravel community. diff --git a/packages/actions/docs/01-installation.md b/packages/actions/docs/01-installation.md deleted file mode 100644 index 85adb7eb02..0000000000 --- a/packages/actions/docs/01-installation.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Installation ---- - -**The Actions package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Actions package in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -Require the Actions package using Composer: - -```bash -composer require filament/actions:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --actions - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Actions package assets: - -```bash -php artisan filament:install --actions -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/actions/docs/02-overview.md b/packages/actions/docs/01-overview.md similarity index 100% rename from packages/actions/docs/02-overview.md rename to packages/actions/docs/01-overview.md diff --git a/packages/actions/docs/03-trigger-button.md b/packages/actions/docs/02-trigger-button.md similarity index 100% rename from packages/actions/docs/03-trigger-button.md rename to packages/actions/docs/02-trigger-button.md diff --git a/packages/actions/docs/04-modals.md b/packages/actions/docs/03-modals.md similarity index 100% rename from packages/actions/docs/04-modals.md rename to packages/actions/docs/03-modals.md diff --git a/packages/actions/docs/05-grouping-actions.md b/packages/actions/docs/04-grouping-actions.md similarity index 100% rename from packages/actions/docs/05-grouping-actions.md rename to packages/actions/docs/04-grouping-actions.md diff --git a/packages/actions/docs/06-adding-an-action-to-a-livewire-component.md b/packages/actions/docs/05-adding-an-action-to-a-livewire-component.md similarity index 100% rename from packages/actions/docs/06-adding-an-action-to-a-livewire-component.md rename to packages/actions/docs/05-adding-an-action-to-a-livewire-component.md diff --git a/packages/actions/docs/07-prebuilt-actions/01-create.md b/packages/actions/docs/06-prebuilt-actions/01-create.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/01-create.md rename to packages/actions/docs/06-prebuilt-actions/01-create.md diff --git a/packages/actions/docs/07-prebuilt-actions/02-edit.md b/packages/actions/docs/06-prebuilt-actions/02-edit.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/02-edit.md rename to packages/actions/docs/06-prebuilt-actions/02-edit.md diff --git a/packages/actions/docs/07-prebuilt-actions/03-view.md b/packages/actions/docs/06-prebuilt-actions/03-view.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/03-view.md rename to packages/actions/docs/06-prebuilt-actions/03-view.md diff --git a/packages/actions/docs/07-prebuilt-actions/04-delete.md b/packages/actions/docs/06-prebuilt-actions/04-delete.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/04-delete.md rename to packages/actions/docs/06-prebuilt-actions/04-delete.md diff --git a/packages/actions/docs/07-prebuilt-actions/05-replicate.md b/packages/actions/docs/06-prebuilt-actions/05-replicate.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/05-replicate.md rename to packages/actions/docs/06-prebuilt-actions/05-replicate.md diff --git a/packages/actions/docs/07-prebuilt-actions/06-force-delete.md b/packages/actions/docs/06-prebuilt-actions/06-force-delete.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/06-force-delete.md rename to packages/actions/docs/06-prebuilt-actions/06-force-delete.md diff --git a/packages/actions/docs/07-prebuilt-actions/07-restore.md b/packages/actions/docs/06-prebuilt-actions/07-restore.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/07-restore.md rename to packages/actions/docs/06-prebuilt-actions/07-restore.md diff --git a/packages/actions/docs/07-prebuilt-actions/08-import.md b/packages/actions/docs/06-prebuilt-actions/08-import.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/08-import.md rename to packages/actions/docs/06-prebuilt-actions/08-import.md diff --git a/packages/actions/docs/07-prebuilt-actions/09-export.md b/packages/actions/docs/06-prebuilt-actions/09-export.md similarity index 100% rename from packages/actions/docs/07-prebuilt-actions/09-export.md rename to packages/actions/docs/06-prebuilt-actions/09-export.md diff --git a/packages/actions/docs/08-advanced.md b/packages/actions/docs/07-advanced.md similarity index 100% rename from packages/actions/docs/08-advanced.md rename to packages/actions/docs/07-advanced.md diff --git a/packages/actions/docs/09-testing.md b/packages/actions/docs/08-testing.md similarity index 100% rename from packages/actions/docs/09-testing.md rename to packages/actions/docs/08-testing.md diff --git a/packages/forms/docs/02-getting-started.md b/packages/forms/docs/01-getting-started.md similarity index 100% rename from packages/forms/docs/02-getting-started.md rename to packages/forms/docs/01-getting-started.md diff --git a/packages/forms/docs/01-installation.md b/packages/forms/docs/01-installation.md deleted file mode 100644 index 405858551d..0000000000 --- a/packages/forms/docs/01-installation.md +++ /dev/null @@ -1,176 +0,0 @@ ---- -title: Installation ---- - -**The Form Builder package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Form Builder in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -Require the Form Builder package using Composer: - -```bash -composer require filament/forms:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --forms - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Form Builder assets: - -```bash -php artisan filament:install --forms -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -> Upgrading from Filament v2? Please review the [upgrade guide](upgrade-guide). - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/forms/docs/03-fields/01-overview.md b/packages/forms/docs/02-fields/01-overview.md similarity index 100% rename from packages/forms/docs/03-fields/01-overview.md rename to packages/forms/docs/02-fields/01-overview.md diff --git a/packages/forms/docs/03-fields/02-text-input.md b/packages/forms/docs/02-fields/02-text-input.md similarity index 100% rename from packages/forms/docs/03-fields/02-text-input.md rename to packages/forms/docs/02-fields/02-text-input.md diff --git a/packages/forms/docs/03-fields/03-select.md b/packages/forms/docs/02-fields/03-select.md similarity index 100% rename from packages/forms/docs/03-fields/03-select.md rename to packages/forms/docs/02-fields/03-select.md diff --git a/packages/forms/docs/03-fields/04-checkbox.md b/packages/forms/docs/02-fields/04-checkbox.md similarity index 100% rename from packages/forms/docs/03-fields/04-checkbox.md rename to packages/forms/docs/02-fields/04-checkbox.md diff --git a/packages/forms/docs/03-fields/05-toggle.md b/packages/forms/docs/02-fields/05-toggle.md similarity index 100% rename from packages/forms/docs/03-fields/05-toggle.md rename to packages/forms/docs/02-fields/05-toggle.md diff --git a/packages/forms/docs/03-fields/06-checkbox-list.md b/packages/forms/docs/02-fields/06-checkbox-list.md similarity index 100% rename from packages/forms/docs/03-fields/06-checkbox-list.md rename to packages/forms/docs/02-fields/06-checkbox-list.md diff --git a/packages/forms/docs/03-fields/07-radio.md b/packages/forms/docs/02-fields/07-radio.md similarity index 100% rename from packages/forms/docs/03-fields/07-radio.md rename to packages/forms/docs/02-fields/07-radio.md diff --git a/packages/forms/docs/03-fields/08-date-time-picker.md b/packages/forms/docs/02-fields/08-date-time-picker.md similarity index 100% rename from packages/forms/docs/03-fields/08-date-time-picker.md rename to packages/forms/docs/02-fields/08-date-time-picker.md diff --git a/packages/forms/docs/03-fields/09-file-upload.md b/packages/forms/docs/02-fields/09-file-upload.md similarity index 100% rename from packages/forms/docs/03-fields/09-file-upload.md rename to packages/forms/docs/02-fields/09-file-upload.md diff --git a/packages/forms/docs/03-fields/10-rich-editor.md b/packages/forms/docs/02-fields/10-rich-editor.md similarity index 100% rename from packages/forms/docs/03-fields/10-rich-editor.md rename to packages/forms/docs/02-fields/10-rich-editor.md diff --git a/packages/forms/docs/03-fields/11-markdown-editor.md b/packages/forms/docs/02-fields/11-markdown-editor.md similarity index 100% rename from packages/forms/docs/03-fields/11-markdown-editor.md rename to packages/forms/docs/02-fields/11-markdown-editor.md diff --git a/packages/forms/docs/03-fields/12-repeater.md b/packages/forms/docs/02-fields/12-repeater.md similarity index 100% rename from packages/forms/docs/03-fields/12-repeater.md rename to packages/forms/docs/02-fields/12-repeater.md diff --git a/packages/forms/docs/03-fields/13-builder.md b/packages/forms/docs/02-fields/13-builder.md similarity index 100% rename from packages/forms/docs/03-fields/13-builder.md rename to packages/forms/docs/02-fields/13-builder.md diff --git a/packages/forms/docs/03-fields/14-tags-input.md b/packages/forms/docs/02-fields/14-tags-input.md similarity index 100% rename from packages/forms/docs/03-fields/14-tags-input.md rename to packages/forms/docs/02-fields/14-tags-input.md diff --git a/packages/forms/docs/03-fields/15-textarea.md b/packages/forms/docs/02-fields/15-textarea.md similarity index 100% rename from packages/forms/docs/03-fields/15-textarea.md rename to packages/forms/docs/02-fields/15-textarea.md diff --git a/packages/forms/docs/03-fields/16-key-value.md b/packages/forms/docs/02-fields/16-key-value.md similarity index 100% rename from packages/forms/docs/03-fields/16-key-value.md rename to packages/forms/docs/02-fields/16-key-value.md diff --git a/packages/forms/docs/03-fields/17-color-picker.md b/packages/forms/docs/02-fields/17-color-picker.md similarity index 100% rename from packages/forms/docs/03-fields/17-color-picker.md rename to packages/forms/docs/02-fields/17-color-picker.md diff --git a/packages/forms/docs/03-fields/18-toggle-buttons.md b/packages/forms/docs/02-fields/18-toggle-buttons.md similarity index 100% rename from packages/forms/docs/03-fields/18-toggle-buttons.md rename to packages/forms/docs/02-fields/18-toggle-buttons.md diff --git a/packages/forms/docs/03-fields/19-hidden.md b/packages/forms/docs/02-fields/19-hidden.md similarity index 100% rename from packages/forms/docs/03-fields/19-hidden.md rename to packages/forms/docs/02-fields/19-hidden.md diff --git a/packages/forms/docs/03-fields/20-custom.md b/packages/forms/docs/02-fields/20-custom.md similarity index 100% rename from packages/forms/docs/03-fields/20-custom.md rename to packages/forms/docs/02-fields/20-custom.md diff --git a/packages/forms/docs/04-adding-a-form-to-a-livewire-component.md b/packages/forms/docs/03-adding-a-form-to-a-livewire-component.md similarity index 100% rename from packages/forms/docs/04-adding-a-form-to-a-livewire-component.md rename to packages/forms/docs/03-adding-a-form-to-a-livewire-component.md diff --git a/packages/forms/docs/05-validation.md b/packages/forms/docs/04-validation.md similarity index 100% rename from packages/forms/docs/05-validation.md rename to packages/forms/docs/04-validation.md diff --git a/packages/forms/docs/07-advanced.md b/packages/forms/docs/05-advanced.md similarity index 100% rename from packages/forms/docs/07-advanced.md rename to packages/forms/docs/05-advanced.md diff --git a/packages/forms/docs/08-testing.md b/packages/forms/docs/06-testing.md similarity index 100% rename from packages/forms/docs/08-testing.md rename to packages/forms/docs/06-testing.md diff --git a/packages/infolists/docs/02-getting-started.md b/packages/infolists/docs/01-getting-started.md similarity index 100% rename from packages/infolists/docs/02-getting-started.md rename to packages/infolists/docs/01-getting-started.md diff --git a/packages/infolists/docs/01-installation.md b/packages/infolists/docs/01-installation.md deleted file mode 100644 index a212a13ad8..0000000000 --- a/packages/infolists/docs/01-installation.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Installation ---- - -**The Infolist Builder package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Infolist Builder package in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -Require the Infolist Builder package using Composer: - -```bash -composer require filament/infolists:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --infolists - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Infolist Builder package assets: - -```bash -php artisan filament:install --infolists -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/infolists/docs/03-entries/01-overview.md b/packages/infolists/docs/02-entries/01-overview.md similarity index 100% rename from packages/infolists/docs/03-entries/01-overview.md rename to packages/infolists/docs/02-entries/01-overview.md diff --git a/packages/infolists/docs/03-entries/02-text.md b/packages/infolists/docs/02-entries/02-text.md similarity index 100% rename from packages/infolists/docs/03-entries/02-text.md rename to packages/infolists/docs/02-entries/02-text.md diff --git a/packages/infolists/docs/03-entries/03-icon.md b/packages/infolists/docs/02-entries/03-icon.md similarity index 100% rename from packages/infolists/docs/03-entries/03-icon.md rename to packages/infolists/docs/02-entries/03-icon.md diff --git a/packages/infolists/docs/03-entries/04-image.md b/packages/infolists/docs/02-entries/04-image.md similarity index 100% rename from packages/infolists/docs/03-entries/04-image.md rename to packages/infolists/docs/02-entries/04-image.md diff --git a/packages/infolists/docs/03-entries/05-color.md b/packages/infolists/docs/02-entries/05-color.md similarity index 100% rename from packages/infolists/docs/03-entries/05-color.md rename to packages/infolists/docs/02-entries/05-color.md diff --git a/packages/infolists/docs/03-entries/06-key-value.md b/packages/infolists/docs/02-entries/06-key-value.md similarity index 100% rename from packages/infolists/docs/03-entries/06-key-value.md rename to packages/infolists/docs/02-entries/06-key-value.md diff --git a/packages/infolists/docs/03-entries/07-repeatable.md b/packages/infolists/docs/02-entries/07-repeatable.md similarity index 100% rename from packages/infolists/docs/03-entries/07-repeatable.md rename to packages/infolists/docs/02-entries/07-repeatable.md diff --git a/packages/infolists/docs/03-entries/08-custom.md b/packages/infolists/docs/02-entries/08-custom.md similarity index 100% rename from packages/infolists/docs/03-entries/08-custom.md rename to packages/infolists/docs/02-entries/08-custom.md diff --git a/packages/infolists/docs/04-adding-an-infolist-to-a-livewire-component.md b/packages/infolists/docs/03-adding-an-infolist-to-a-livewire-component.md similarity index 100% rename from packages/infolists/docs/04-adding-an-infolist-to-a-livewire-component.md rename to packages/infolists/docs/03-adding-an-infolist-to-a-livewire-component.md diff --git a/packages/infolists/docs/05-advanced.md b/packages/infolists/docs/04-advanced.md similarity index 100% rename from packages/infolists/docs/05-advanced.md rename to packages/infolists/docs/04-advanced.md diff --git a/packages/infolists/docs/06-testing.md b/packages/infolists/docs/05-testing.md similarity index 100% rename from packages/infolists/docs/06-testing.md rename to packages/infolists/docs/05-testing.md diff --git a/packages/notifications/docs/01-installation.md b/packages/notifications/docs/01-installation.md deleted file mode 100644 index d97ecf2b98..0000000000 --- a/packages/notifications/docs/01-installation.md +++ /dev/null @@ -1,176 +0,0 @@ ---- -title: Installation ---- - -**The Notifications package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Notifications package in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -Require the Notifications package using Composer: - -```bash -composer require filament/notifications:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --notifications - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Notifications package assets: - -```bash -php artisan filament:install --notifications -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @livewire('notifications') - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -> Upgrading from Filament v2? Please review the [upgrade guide](upgrade-guide). - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/notifications/docs/02-sending-notifications.md b/packages/notifications/docs/01-sending-notifications.md similarity index 100% rename from packages/notifications/docs/02-sending-notifications.md rename to packages/notifications/docs/01-sending-notifications.md diff --git a/packages/notifications/docs/03-database-notifications.md b/packages/notifications/docs/02-database-notifications.md similarity index 100% rename from packages/notifications/docs/03-database-notifications.md rename to packages/notifications/docs/02-database-notifications.md diff --git a/packages/notifications/docs/04-broadcast-notifications.md b/packages/notifications/docs/03-broadcast-notifications.md similarity index 100% rename from packages/notifications/docs/04-broadcast-notifications.md rename to packages/notifications/docs/03-broadcast-notifications.md diff --git a/packages/notifications/docs/05-customizing-notifications.md b/packages/notifications/docs/04-customizing-notifications.md similarity index 100% rename from packages/notifications/docs/05-customizing-notifications.md rename to packages/notifications/docs/04-customizing-notifications.md diff --git a/packages/notifications/docs/06-testing.md b/packages/notifications/docs/05-testing.md similarity index 100% rename from packages/notifications/docs/06-testing.md rename to packages/notifications/docs/05-testing.md diff --git a/packages/panels/docs/02-getting-started.md b/packages/panels/docs/01-getting-started.md similarity index 100% rename from packages/panels/docs/02-getting-started.md rename to packages/panels/docs/01-getting-started.md diff --git a/packages/panels/docs/01-installation.md b/packages/panels/docs/01-installation.md deleted file mode 100644 index 3278ca6bcb..0000000000 --- a/packages/panels/docs/01-installation.md +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: Installation ---- - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -> If you are upgrading from Filament v2, please review the [upgrade guide](upgrade-guide). - -Install the Filament Panel Builder by running the following commands in your Laravel project directory: - -```bash -composer require filament/filament:"^3.2" -W - -php artisan filament:install --panels -``` - -This will create and register a new [Laravel service provider](https://laravel.com/docs/providers) called `app/Providers/Filament/AdminPanelProvider.php`. - -> If you get an error when accessing your panel, check that the service provider was registered in `bootstrap/providers.php` (Laravel 11 and above) or `config/app.php` (Laravel 10 and below). If not, you should manually add it. - -## Create a user -You can create a new user account with the following command: - -```bash -php artisan make:filament-user -``` - -Open `/admin` in your web browser, sign in, and start building your app! - -Not sure where to start? Review the [Getting Started guide](getting-started) to learn how to build a complete Filament admin panel. - -## Using other Filament packages -The Filament Panel Builder pre-installs the [Form Builder](../forms), [Table Builder](../tables), [Notifications](../notifications), [Actions](../actions), [Infolists](../infolists), and [Widgets](../widgets) packages. No other installation steps are required to use these packages within a panel. - -## Improving Filament panel performance - -### Optimizing Filament for production - -To optimize Filament for production, you should run the following command in your deployment script: - -```bash -php artisan filament:optimize -``` - -This command will [cache the Filament components](#caching-filament-components) and additionally the [Blade icons](#caching-blade-icons), which can significantly improve the performance of your Filament panels. This command is a shorthand for the commands `php artisan filament:cache-components` and `php artisan icons:cache`. - -To clear the caches at once, you can run: - -```bash -php artisan filament:optimize-clear -``` - -#### Caching Filament components - -If you're not using the [`filament:optimize` command](#optimizing-filament-for-production), you may wish to consider running `php artisan filament:cache-components` in your deployment script, especially if you have large numbers of components (resources, pages, widgets, relation managers, custom Livewire components, etc.). This will create cache files in the `bootstrap/cache/filament` directory of your application, which contain indexes for each type of component. This can significantly improve the performance of Filament in some apps, as it reduces the number of files that need to be scanned and auto-discovered for components. - -However, if you are actively developing your app locally, you should avoid using this command, as it will prevent any new components from being discovered until the cache is cleared or rebuilt. - -You can clear the cache at any time without rebuilding it by running `php artisan filament:clear-cached-components`. - -#### Caching Blade Icons - -If you're not using the [`filament:optimize` command](#optimizing-filament-for-production), you may wish to consider running `php artisan icons:cache` locally, and also in your deployment script. This is because Filament uses the [Blade Icons](https://blade-ui-kit.com/blade-icons) package, which can be much more performant when cached. - -### Enabling OPcache on your server - -From the [Laravel Forge documentation](https://forge.laravel.com/docs/servers/php.html#opcache): - -> Optimizing the PHP OPcache for production will configure OPcache to store your compiled PHP code in memory to greatly improve performance. - -Please use a search engine to find the relevant OPcache setup instructions for your environment. - -### Optimizing your Laravel app - -You should also consider optimizing your Laravel app for production by running `php artisan optimize` in your deployment script. This will cache the configuration files and routes. - -## Deploying to production - -### Allowing users to access a panel - -By default, all `User` models can access Filament locally. However, when deploying to production, you must update your `App\Models\User.php` to implement the `FilamentUser` contract — ensuring that only the correct users can access your panel: - -```php -email, '@yourdomain.com') && $this->hasVerifiedEmail(); - } -} -``` - -> If you don't complete these steps, a 403 Forbidden error will be returned when accessing the app in production. - -Learn more about [users](users). - -## Publishing configuration - -You can publish the Filament package configuration (if needed) using the following command: - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Publishing translations - -You can publish the language files for translations (if needed) with the following command: - -```bash -php artisan vendor:publish --tag=filament-panels-translations -``` - -Since this package depends on other Filament packages, you can publish the language files for those packages with the following commands: - -```bash -php artisan vendor:publish --tag=filament-actions-translations - -php artisan vendor:publish --tag=filament-forms-translations - -php artisan vendor:publish --tag=filament-infolists-translations - -php artisan vendor:publish --tag=filament-notifications-translations - -php artisan vendor:publish --tag=filament-tables-translations - -php artisan vendor:publish --tag=filament-translations -``` - -## Upgrading - -> Upgrading from Filament v2? Please review the [upgrade guide](upgrade-guide). - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/panels/docs/03-resources/01-overview.md b/packages/panels/docs/02-resources/01-overview.md similarity index 100% rename from packages/panels/docs/03-resources/01-overview.md rename to packages/panels/docs/02-resources/01-overview.md diff --git a/packages/panels/docs/03-resources/02-listing-records.md b/packages/panels/docs/02-resources/02-listing-records.md similarity index 100% rename from packages/panels/docs/03-resources/02-listing-records.md rename to packages/panels/docs/02-resources/02-listing-records.md diff --git a/packages/panels/docs/03-resources/03-creating-records.md b/packages/panels/docs/02-resources/03-creating-records.md similarity index 100% rename from packages/panels/docs/03-resources/03-creating-records.md rename to packages/panels/docs/02-resources/03-creating-records.md diff --git a/packages/panels/docs/03-resources/04-editing-records.md b/packages/panels/docs/02-resources/04-editing-records.md similarity index 100% rename from packages/panels/docs/03-resources/04-editing-records.md rename to packages/panels/docs/02-resources/04-editing-records.md diff --git a/packages/panels/docs/03-resources/05-viewing-records.md b/packages/panels/docs/02-resources/05-viewing-records.md similarity index 100% rename from packages/panels/docs/03-resources/05-viewing-records.md rename to packages/panels/docs/02-resources/05-viewing-records.md diff --git a/packages/panels/docs/03-resources/06-deleting-records.md b/packages/panels/docs/02-resources/06-deleting-records.md similarity index 100% rename from packages/panels/docs/03-resources/06-deleting-records.md rename to packages/panels/docs/02-resources/06-deleting-records.md diff --git a/packages/panels/docs/03-resources/07-relation-managers.md b/packages/panels/docs/02-resources/07-relation-managers.md similarity index 100% rename from packages/panels/docs/03-resources/07-relation-managers.md rename to packages/panels/docs/02-resources/07-relation-managers.md diff --git a/packages/panels/docs/03-resources/08-global-search.md b/packages/panels/docs/02-resources/08-global-search.md similarity index 100% rename from packages/panels/docs/03-resources/08-global-search.md rename to packages/panels/docs/02-resources/08-global-search.md diff --git a/packages/panels/docs/03-resources/09-widgets.md b/packages/panels/docs/02-resources/09-widgets.md similarity index 100% rename from packages/panels/docs/03-resources/09-widgets.md rename to packages/panels/docs/02-resources/09-widgets.md diff --git a/packages/panels/docs/03-resources/10-custom-pages.md b/packages/panels/docs/02-resources/10-custom-pages.md similarity index 100% rename from packages/panels/docs/03-resources/10-custom-pages.md rename to packages/panels/docs/02-resources/10-custom-pages.md diff --git a/packages/panels/docs/03-resources/11-security.md b/packages/panels/docs/02-resources/11-security.md similarity index 100% rename from packages/panels/docs/03-resources/11-security.md rename to packages/panels/docs/02-resources/11-security.md diff --git a/packages/panels/docs/04-pages.md b/packages/panels/docs/03-pages.md similarity index 100% rename from packages/panels/docs/04-pages.md rename to packages/panels/docs/03-pages.md diff --git a/packages/panels/docs/05-dashboard.md b/packages/panels/docs/04-dashboard.md similarity index 100% rename from packages/panels/docs/05-dashboard.md rename to packages/panels/docs/04-dashboard.md diff --git a/packages/panels/docs/06-navigation.md b/packages/panels/docs/05-navigation.md similarity index 100% rename from packages/panels/docs/06-navigation.md rename to packages/panels/docs/05-navigation.md diff --git a/packages/panels/docs/07-notifications.md b/packages/panels/docs/06-notifications.md similarity index 100% rename from packages/panels/docs/07-notifications.md rename to packages/panels/docs/06-notifications.md diff --git a/packages/panels/docs/08-users.md b/packages/panels/docs/07-users.md similarity index 100% rename from packages/panels/docs/08-users.md rename to packages/panels/docs/07-users.md diff --git a/packages/panels/docs/09-configuration.md b/packages/panels/docs/08-configuration.md similarity index 100% rename from packages/panels/docs/09-configuration.md rename to packages/panels/docs/08-configuration.md diff --git a/packages/panels/docs/10-clusters.md b/packages/panels/docs/09-clusters.md similarity index 100% rename from packages/panels/docs/10-clusters.md rename to packages/panels/docs/09-clusters.md diff --git a/packages/panels/docs/11-tenancy.md b/packages/panels/docs/10-tenancy.md similarity index 100% rename from packages/panels/docs/11-tenancy.md rename to packages/panels/docs/10-tenancy.md diff --git a/packages/panels/docs/12-themes.md b/packages/panels/docs/11-themes.md similarity index 100% rename from packages/panels/docs/12-themes.md rename to packages/panels/docs/11-themes.md diff --git a/packages/panels/docs/13-plugins.md b/packages/panels/docs/12-plugins.md similarity index 100% rename from packages/panels/docs/13-plugins.md rename to packages/panels/docs/12-plugins.md diff --git a/packages/panels/docs/14-testing.md b/packages/panels/docs/13-testing.md similarity index 100% rename from packages/panels/docs/14-testing.md rename to packages/panels/docs/13-testing.md diff --git a/packages/tables/docs/02-getting-started.md b/packages/tables/docs/01-getting-started.md similarity index 100% rename from packages/tables/docs/02-getting-started.md rename to packages/tables/docs/01-getting-started.md diff --git a/packages/tables/docs/01-installation.md b/packages/tables/docs/01-installation.md deleted file mode 100644 index 818d54d869..0000000000 --- a/packages/tables/docs/01-installation.md +++ /dev/null @@ -1,176 +0,0 @@ ---- -title: Installation ---- - -**The Table Builder package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Table Builder in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -Require the Table Builder package using Composer: - -```bash -composer require filament/tables:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --tables - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Table Builder assets: - -```bash -php artisan filament:install --tables -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -> Upgrading from Filament v2? Please review the [upgrade guide](upgrade-guide). - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/tables/docs/03-columns/01-overview.md b/packages/tables/docs/02-columns/01-overview.md similarity index 100% rename from packages/tables/docs/03-columns/01-overview.md rename to packages/tables/docs/02-columns/01-overview.md diff --git a/packages/tables/docs/03-columns/02-text.md b/packages/tables/docs/02-columns/02-text.md similarity index 100% rename from packages/tables/docs/03-columns/02-text.md rename to packages/tables/docs/02-columns/02-text.md diff --git a/packages/tables/docs/03-columns/03-icon.md b/packages/tables/docs/02-columns/03-icon.md similarity index 100% rename from packages/tables/docs/03-columns/03-icon.md rename to packages/tables/docs/02-columns/03-icon.md diff --git a/packages/tables/docs/03-columns/04-image.md b/packages/tables/docs/02-columns/04-image.md similarity index 100% rename from packages/tables/docs/03-columns/04-image.md rename to packages/tables/docs/02-columns/04-image.md diff --git a/packages/tables/docs/03-columns/05-color.md b/packages/tables/docs/02-columns/05-color.md similarity index 100% rename from packages/tables/docs/03-columns/05-color.md rename to packages/tables/docs/02-columns/05-color.md diff --git a/packages/tables/docs/03-columns/06-select.md b/packages/tables/docs/02-columns/06-select.md similarity index 100% rename from packages/tables/docs/03-columns/06-select.md rename to packages/tables/docs/02-columns/06-select.md diff --git a/packages/tables/docs/03-columns/07-toggle.md b/packages/tables/docs/02-columns/07-toggle.md similarity index 100% rename from packages/tables/docs/03-columns/07-toggle.md rename to packages/tables/docs/02-columns/07-toggle.md diff --git a/packages/tables/docs/03-columns/08-text-input.md b/packages/tables/docs/02-columns/08-text-input.md similarity index 100% rename from packages/tables/docs/03-columns/08-text-input.md rename to packages/tables/docs/02-columns/08-text-input.md diff --git a/packages/tables/docs/03-columns/09-checkbox.md b/packages/tables/docs/02-columns/09-checkbox.md similarity index 100% rename from packages/tables/docs/03-columns/09-checkbox.md rename to packages/tables/docs/02-columns/09-checkbox.md diff --git a/packages/tables/docs/03-columns/10-custom.md b/packages/tables/docs/02-columns/10-custom.md similarity index 100% rename from packages/tables/docs/03-columns/10-custom.md rename to packages/tables/docs/02-columns/10-custom.md diff --git a/packages/tables/docs/03-columns/11-relationships.md b/packages/tables/docs/02-columns/11-relationships.md similarity index 100% rename from packages/tables/docs/03-columns/11-relationships.md rename to packages/tables/docs/02-columns/11-relationships.md diff --git a/packages/tables/docs/03-columns/12-advanced.md b/packages/tables/docs/02-columns/12-advanced.md similarity index 100% rename from packages/tables/docs/03-columns/12-advanced.md rename to packages/tables/docs/02-columns/12-advanced.md diff --git a/packages/tables/docs/04-filters/01-overview.md b/packages/tables/docs/03-filters/01-overview.md similarity index 100% rename from packages/tables/docs/04-filters/01-overview.md rename to packages/tables/docs/03-filters/01-overview.md diff --git a/packages/tables/docs/04-filters/02-select.md b/packages/tables/docs/03-filters/02-select.md similarity index 100% rename from packages/tables/docs/04-filters/02-select.md rename to packages/tables/docs/03-filters/02-select.md diff --git a/packages/tables/docs/04-filters/03-ternary.md b/packages/tables/docs/03-filters/03-ternary.md similarity index 100% rename from packages/tables/docs/04-filters/03-ternary.md rename to packages/tables/docs/03-filters/03-ternary.md diff --git a/packages/tables/docs/04-filters/04-query-builder.md b/packages/tables/docs/03-filters/04-query-builder.md similarity index 100% rename from packages/tables/docs/04-filters/04-query-builder.md rename to packages/tables/docs/03-filters/04-query-builder.md diff --git a/packages/tables/docs/04-filters/05-custom.md b/packages/tables/docs/03-filters/05-custom.md similarity index 100% rename from packages/tables/docs/04-filters/05-custom.md rename to packages/tables/docs/03-filters/05-custom.md diff --git a/packages/tables/docs/04-filters/06-layout.md b/packages/tables/docs/03-filters/06-layout.md similarity index 100% rename from packages/tables/docs/04-filters/06-layout.md rename to packages/tables/docs/03-filters/06-layout.md diff --git a/packages/tables/docs/05-actions.md b/packages/tables/docs/04-actions.md similarity index 100% rename from packages/tables/docs/05-actions.md rename to packages/tables/docs/04-actions.md diff --git a/packages/tables/docs/06-layout.md b/packages/tables/docs/05-layout.md similarity index 100% rename from packages/tables/docs/06-layout.md rename to packages/tables/docs/05-layout.md diff --git a/packages/tables/docs/07-summaries.md b/packages/tables/docs/06-summaries.md similarity index 100% rename from packages/tables/docs/07-summaries.md rename to packages/tables/docs/06-summaries.md diff --git a/packages/tables/docs/08-grouping.md b/packages/tables/docs/07-grouping.md similarity index 100% rename from packages/tables/docs/08-grouping.md rename to packages/tables/docs/07-grouping.md diff --git a/packages/tables/docs/09-empty-state.md b/packages/tables/docs/08-empty-state.md similarity index 100% rename from packages/tables/docs/09-empty-state.md rename to packages/tables/docs/08-empty-state.md diff --git a/packages/tables/docs/10-advanced.md b/packages/tables/docs/09-advanced.md similarity index 100% rename from packages/tables/docs/10-advanced.md rename to packages/tables/docs/09-advanced.md diff --git a/packages/tables/docs/11-adding-a-table-to-a-livewire-component.md b/packages/tables/docs/10-adding-a-table-to-a-livewire-component.md similarity index 100% rename from packages/tables/docs/11-adding-a-table-to-a-livewire-component.md rename to packages/tables/docs/10-adding-a-table-to-a-livewire-component.md diff --git a/packages/tables/docs/12-testing.md b/packages/tables/docs/11-testing.md similarity index 100% rename from packages/tables/docs/12-testing.md rename to packages/tables/docs/11-testing.md diff --git a/packages/upgrade/bin/filament-v4 b/packages/upgrade/bin/filament-v4 index 09f2be50ba..ab317b56ae 100755 --- a/packages/upgrade/bin/filament-v4 +++ b/packages/upgrade/bin/filament-v4 @@ -70,7 +70,7 @@ if ( The FILAMENT_FILESYSTEM_DISK has been removed, and the default configuration file now references the FILESYSTEM_DISK environment variable. Please read the - documentation + documentation for more information. and press any key to continue. HTML); diff --git a/packages/widgets/docs/01-installation.md b/packages/widgets/docs/01-installation.md deleted file mode 100644 index 9148963047..0000000000 --- a/packages/widgets/docs/01-installation.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: Installation ---- - -**The Widgets package is pre-installed with the [Panel Builder](../panels).** This guide is for using the Widgets package in a custom TALL Stack application (Tailwind, Alpine, Livewire, Laravel). - -## Requirements - -Filament requires the following to run: - -- PHP 8.1+ -- Laravel v10.0+ -- Livewire v3.0+ - -## Installation - -Require the Widgets package using Composer: - -```bash -composer require filament/widgets:"^3.2" -W -``` - -## New Laravel projects - -To quickly get started with Filament in a new Laravel project, run the following commands to install [Livewire](https://livewire.laravel.com), [Alpine.js](https://alpinejs.dev), and [Tailwind CSS](https://tailwindcss.com): - -> Since these commands will overwrite existing files in your application, only run this in a new Laravel project! - -```bash -php artisan filament:install --scaffold --widgets - -npm install - -npm run dev -``` - -## Existing Laravel projects - -Run the following command to install the Widgets package assets: - -```bash -php artisan filament:install --widgets -``` - -### Installing Tailwind CSS - -Run the following command to install Tailwind CSS with the Tailwind Forms and Typography plugins: - -```bash -npm install tailwindcss @tailwindcss/forms @tailwindcss/typography postcss postcss-nesting autoprefixer --save-dev -``` - -Create a new `tailwind.config.js` file and add the Filament `preset` *(includes the Filament color scheme and the required Tailwind plugins)*: - -```js -import preset from './vendor/filament/support/tailwind.config.preset' - -export default { - presets: [preset], - content: [ - './app/Filament/**/*.php', - './resources/views/filament/**/*.blade.php', - './vendor/filament/**/*.blade.php', - ], -} -``` - -### Configuring styles - -Add Tailwind's CSS layers to your `resources/css/app.css`: - -```css -@tailwind base; -@tailwind components; -@tailwind utilities; -``` - -Create a `postcss.config.js` file in the root of your project and register Tailwind CSS, PostCSS Nesting and Autoprefixer as plugins: - -```js -export default { - plugins: { - 'tailwindcss/nesting': 'postcss-nesting', - tailwindcss: {}, - autoprefixer: {}, - }, -} -``` - -### Automatically refreshing the browser -You may also want to update your `vite.config.js` file to refresh the page automatically when Livewire components are updated: - -```js -import { defineConfig } from 'vite' -import laravel, { refreshPaths } from 'laravel-vite-plugin' - -export default defineConfig({ - plugins: [ - laravel({ - input: ['resources/css/app.css', 'resources/js/app.js'], - refresh: [ - ...refreshPaths, - 'app/Livewire/**', - ], - }), - ], -}) -``` - -### Compiling assets - -Compile your new CSS and Javascript assets using `npm run dev`. - -### Configuring your layout - -Create a new `resources/views/components/layouts/app.blade.php` layout file for Livewire components: - -```blade - - - - - - - - - - {{ config('app.name') }} - - - - @filamentStyles - @vite('resources/css/app.css') - - - - {{ $slot }} - - @filamentScripts - @vite('resources/js/app.js') - - -``` - -## Publishing configuration - -You can publish the package configuration using the following command (optional): - -```bash -php artisan vendor:publish --tag=filament-config -``` - -## Upgrading - -Filament automatically upgrades to the latest non-breaking version when you run `composer update`. After any updates, all Laravel caches need to be cleared, and frontend assets need to be republished. You can do this all at once using the `filament:upgrade` command, which should have been added to your `composer.json` file when you ran `filament:install` the first time: - -```json -"post-autoload-dump": [ - // ... - "@php artisan filament:upgrade" -], -``` - -Please note that `filament:upgrade` does not actually handle the update process, as Composer does that already. If you're upgrading manually without a `post-autoload-dump` hook, you can run the command yourself: - -```bash -composer update - -php artisan filament:upgrade -``` diff --git a/packages/widgets/docs/02-stats-overview.md b/packages/widgets/docs/01-stats-overview.md similarity index 100% rename from packages/widgets/docs/02-stats-overview.md rename to packages/widgets/docs/01-stats-overview.md diff --git a/packages/widgets/docs/03-charts.md b/packages/widgets/docs/02-charts.md similarity index 100% rename from packages/widgets/docs/03-charts.md rename to packages/widgets/docs/02-charts.md diff --git a/packages/widgets/docs/04-tables.md b/packages/widgets/docs/03-tables.md similarity index 100% rename from packages/widgets/docs/04-tables.md rename to packages/widgets/docs/03-tables.md diff --git a/packages/widgets/docs/05-adding-a-widget-to-a-blade-view.md b/packages/widgets/docs/04-adding-a-widget-to-a-blade-view.md similarity index 100% rename from packages/widgets/docs/05-adding-a-widget-to-a-blade-view.md rename to packages/widgets/docs/04-adding-a-widget-to-a-blade-view.md