Hey @jaydrogers,

I wouldn't say there are a lot of steps in installing Filament alone, but overall, from nothing to App, yes of cour!!
Sidenote: we should do a call/livestream, playing with Spin + Filament, because, I haven't had time to start with Spin, and you have to try Filament! 2 in 1 :D :D

The typical install

Panels include all packages. They are separate, because if you have a Laravel app, and want Forms you can cherry pick just that, without panels. Same goes for others.

Filament is a foundation, a set of tools, for App Development. People tend to see it as a Admin Panel, but it's so much more.

Typically, you run these 2 commands, and you're good to go:

composer require filament/filament:"^3.2" -W
php artisan filament:install --panels

Either you seed a database user, or you can create it right away:

php artisan make:filament-user

Filament (and other apps) with presets

I have to propose and can collaborate on:
Templates/Presets, that would include requiring composer packages, installing npm packages, changing some files, running artisan commands, etc and checks for asserting the template did a good job!

This could be a yaml/json file, and could be in the source, or made on a website. Look at this example, from https://start.spring.io

This could generate a file, or a command script. Say: I click save and copy a string spin init --template=uuid-generated-for-my-template which I can paste into terminal and GO!

This uuid would feed from that app, and would return said json, and spin would feed from that.

This could go on for hours, but not sure if you want to follow this path, so let me know!

This would also apply to infrastructure things like: redis? queue? horizon? cron? etc

Further discussion

1. Can't foresee any issue. As above, run 2 commands, provided the default stuff and db are ready, and you're good to go.
2. Nope, not out of the box. Even when we make. custom theme, it's a regular npm run dev as usual.
3. It could be awesome to have a setup for PDF generation, using Puppeteer or Playwright. I have experience with this, so let me know if you want to tinker!!

This looks great, @jaydrogers! Really excited to get Filament and Spin working together!

Just had a few thoughts to share:

Compatibility

As long as the Laravel app supports Filament's requirements (below), there should be no issue whatsoever with installing Filament when running spin new

• PHP 8.1+
• Laravel 10.0+
• Livewire 3.0+

When installing Filament, if Livewire isn't already installed, Composer will pull Livewire 3 in as a dependency, so there shouldn't be anything to worry about there.

Needing Node in the PHP container

We shouldn't need to add Node into the PHP container. Anything we need Node for (compiling front-end assets on individual plugins and custom themes) should be able to just use the existing Node container that Spin created by default.

Filament Panel vs. individual plugins

As you noted in your original post, Filament is actually an ecosystem of TALL stack packages that can be used individually or combined together. The one outlier here is the Panel builder package. Panel builder is actually an opinionated combination of all of our other Filament packages.

I bring this up because, in the install script, if someone chooses the "panel" option, we'll likely want to prevent them from selecting the rest or auto-select them since they will be installed anyways.

Beyond that, though, all of the remaining packages can be installed in whatever combination people want!

Using Filament with spin init

I've been thinking about this a bit and talking with Dan (Filament creator), and I'm not actually sure if adding Filament to an existing app with spin init is an absolutely necessary feature. It seems like spin init is mostly for creating Docker infrastructure that works with an existing Laravel app, but Filament will run entirely in the existing PHP container that is already being used by the Laravel app. I'm open for push-back here, but it seems like it would be more simple to composer require Filament into an app and save ourselves the time of writing that logic into Spin. I think the only area where this breaks down is that we also need to include PHP extensions that aren't present in the default Spin install, so maybe we do need to implement this in spin init. Alternatively, I'm open to adding some level of documentation in Filament calling out how to add those extensions to Spin's docker files, but it's still a manual step for people to take.

If you decide that you do want to support Filament in spin init (even if just for consistency's sake between spin new and spin init), there is one thing to note. The Panel builder can be dropped into an existing application with no issues. However, the individual packages have one extra piece of configuration that could make adding them to existing applications more difficult.

When installing any of the individual packages, we also present users with the ability to scaffold their Laravel application. When scaffolding, we automatically set up the TALL stack along with installing our components. This is a destructive operation that automatically goes in and changes files in the application (app.blade.php, for example), so we only recommend doing this for new applications.

We can install individual packages without scaffolding, but then if the user has not previously set up the TALL stack, our components are going to be pretty much useless.

All that said, it's only something we need to think about if we decide to allow people to add Filament to the application with spin init. We may be able to punt that decision down the road a bit too if we want to add Filament in just on spin new.

The intl extension

Something else to think about as well–it might be worthwhile for spin init to look at the composer.json file and, if Filament has been added to the Laravel app, automatically add the intl extension to the Docker containers 🤷🏻‍♂️

Happy to help with whatever you need on the Filament side! Would love to see this come to life and get people using Filament with Docker!

Hey @jaydrogers

Speaking of it....

https://x.com/shadcn/status/1836870732070146468