Create PowerGrid Tables

• Naming convention
• Creating Components in Subdirectories
• Auto-import fields
• Customizing the Creation Process

Reference for php artisan powergrid:create. For the step-by-step walkthrough, see Create a PowerGrid Table.

Naming convention

Use CamelCase, for example ProductTable. The generator kebab-cases that name for the Livewire tag (<livewire:product-table />) and camel-cases it for $tableName, appending Table when the name does not end with it (Product → productTable).

Creating Components in Subdirectories

Prefix the name with a path. Tables/Product/ProductTable writes ProductTable under Tables/Product inside Livewire's class namespace (default app/Livewire).

The Livewire tag uses dot notation: <livewire:tables.product.product-table />.

Auto-import fields

Eloquent and Query Builder can auto-import columns. Collection cannot.

After you confirm auto-import:

• Eloquent — choose $fillable on the model or the database table schema.
• Query Builder — fields come from the table you selected. There is no fillable prompt.

If you decline auto-import or discard the preview, the generator uses the default stub (sample id / name / created_at columns plus Action). If the chosen source has no fields, only the Action column is generated.

Customizing the Creation Process

Component Stubs

Default stubs (under the package resources/stubs/):

Datasource	Stub	With auto-import
Eloquent Builder	table.model.stub	table.model.fillable.stub
Query Builder	table.query-builder.stub	table.query-builder.fillable.stub
Collection	table.collection.stub	—

Publish the Eloquent model stub:

php artisan powergrid:publish --type=stub

That copies stubs/table.model.stub. Duplicate it, then:

php artisan powergrid:create --template=stubs/custom-component.stub

--template is a path relative to the project root. When you pass it, the generator does not switch to a .fillable.stub.

Custom Namespace

Components are written under Livewire's class_namespace (config/livewire.php). See Custom Namespace.

Custom Model Location

The Eloquent model picker scans livewire-powergrid.auto_discover_models_paths. See Auto-Discover Models.