log1x / filament-starter

A beautiful starting point for your next TALL stack project using Filament. ⚡

Filament Starter

Here lives a beautiful starting point to quickly bootstrap your next TALL stack application utilizing Filament for the admin panel.

Features

• 🚀 Quick, clean starting point with an example Post model and resource.
• 🧑‍💻 Fully pre-configured and customized Filament panel with best practices in place.
• 🎨 Clean, minimally styled frontend powered by Livewire.
• 💄 TailwindCSS and Vite ready for immediate use.
• 👷 Pre-bundled Livewire and Alpine for easy extendability.
• ⚡️ SPA-ready in both Filament and the frontend.
• 🔨 GitHub Actions workflows for Pint with pre-configured Dependabot for dependencies.
• 🔍️ Easy programmatic SEO using romanzipp/laravel-seo.

Requirements

Make sure all dependencies have been installed before moving on:

• PHP >= 8.2
• Composer
• Node.js >= 18
• Yarn

Getting Started

Start by creating the project using Composer and configuring the .env file:

composer create-project log1x/filament-starter:dev-main
cd filament-starter

After .env is configured, you can proceed to migrate & seed the database:

php artisan migrate:fresh --seed

Once the database is seeded, you can login at /admin using the default admin user:

Username: admin
Password: admin

Build Assets

The project assets are compiled using Vite. This can be done by installing the dependencies and running the build command with Yarn.

yarn install
yarn build

Plugins Used

The following Filament plugins come fully implemented and configured out of the box:

Plugin	Description	Author
Curator	A beautiful media library.	awcodes
Gravatar	Easy avatar integration powered by Gravatar.	awcodes
Exceptions	A simple but powerful Exception viewer.	bezhansalleh
Jobs Monitor	Easily monitor background jobs and their progress.	croustibat
Breezy	Customizable user profile pages and 2FA support.	jeffgreco13
Peek	Quick & efficient front-end previews of resources.	pboivin
Logger	Zero-config resource activity logging.	z3d0x

Bug Reports

If you discover a bug in Filament Starter, please open an issue.

Contributing

Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.

License

Filament Starter is provided under the MIT License.

filament-starter's Issues

public dir does not contain htaccess file

Hey @Log1x , First of all, thank you so much for this wonderful starter, it means a lot to get started quickly, just wondering why we haven't added the default htaccess file, I thought it might be a good idea to know the reason before submitting the PR. I just installed it, configured the vhost and couldn't get through other pages until I added the htaccess file.

🧑‍💻 Improve the sitemap generation command

The sitemap command needs refactored to automatically detect Filament resources with perhaps a property set to true to automatically handle sitemap generation instead of it being hardcoded to posts.

The sitemap could also be handled dynamically, but I typically work with larger data-heavy sites where that isn't a sane option.

Class "NumberFormatter" not found

Hello!
i just run the project but when i try check posts on admin i get this error :

Class "NumberFormatter" not found

Can you help me ? thanks

Undefined function error "operator does not exist: text ->> unknown" with PostgreSQL

I'm a noob trying out the starter and followed the install instructions, except changed the DB_CONNECTION=pgsql in the .env file. The migrations and seeds ran without a hitch. However, when I navigate anywhere in the admin panel I get a query exception:

SQLSTATE[42883]: Undefined function: 7 ERROR: operator does not exist: text ->> unknown LINE 1: ...ifications"."notifiable_id" is not null and "data"->>'format... ^ HINT: No operator matches the given name and argument types. You might need to add explicit type casts.
select * from "notifications" where "notifications"."notifiable_type" = App\Models\User and "notifications"."notifiable_id" = 1 and "notifications"."notifiable_id" is not null and "data"->>'format' = filament order by "created_at" desc limit 51 offset 0

I've poked around a bit but not sure where to start troubleshooting this. Seems clearly to have to do with using PostgreSQL, but I'm looking for some expert guidance on how to go about fixing this. Any help?

Separate Users ( Frontend ) and Admin (Filament Users )

It will be nice if you can separate users from the frontend and admin users for the backend.
I know that this can be done in Filament with a custom user guard.

Change navigation icon and group for filament-exceptions and filament-logger

How to I change the panel navigation icon and group name for filament-exceptions and filament-logger?

Plugins

https://filamentphp.com/plugins/shuvroroy-spatie-laravel-backup
https://filamentphp.com/plugins/joshembling-image-optimizer
https://filamentphp.com/plugins/ralphjsmit-seo
https://filamentphp.com/plugins/kenepa-translation-manager
https://filamentphp.com/plugins/lara-zeus-wind

And if you can, a section of pages like this in the post section.

and so we have a wordpress

The POST method is not supported for route admin/login. Supported methods: GET, HEAD.

Hello

When transferring to hosing, the following message appears when logging in:

The POST method is not supported for route admin/login. Supported methods: GET, HEAD.

applies to the page: https://host238122.xce.pl/filament/public/admin/login

user:admin
pass:123456789

Integration with filament-tiptap-editor

Do you have any plan for integrating with this https://github.com/awcodes/filament-tiptap-editor ?

💄 Improve the default frontend design

Need To Update to newer Version

hello, I have a problem related to project installation, in the installation section I get an error that "your lock file does not contain a compatible set of packages. please run composer update", but the file is downloaded, and I need to run Composer Update to use it after the error.

what should I do?

🔍️ Add article schema to the PostShow component

This will add spatie/schema-org as a dependency.

Call to undefined relationship [url] on model [Awcodes\Curator\Models\Media]

When "toggling" the List View icon on the Media resource listing page, the following error is thrown:

Call to undefined relationship [url] on model [Awcodes\Curator\Models\Media].

I'm not sure if this is an issue with the Filament plugin or not as I found this:

awcodes/filament-curator#417

Logo shared between frontend and filament - adapt tailwind config if use tailwind

Hi, Thanks for this starter :) I'm discovering Laravel and Filament, and I think it's a great start 👍

I wanted to change the logo on the filament side and discover that it was not picking up tailwind there and that's because the logo is in /resources/views/components/logo.blade.php which is not set in the "content" of tailwind.admin.js

You can fix the issue by just adding this line in the content of the tailwind.admin.js

 "./resources/**/*.blade.php"

but maybe it's worth to create a separate logo file in the filament view folder so we don't generate more class than needed for tailwind (eg the class use in the frontend but not in filament).

Remove lock files

As this is a project template, it must not have composer.lock and yarn.lock files.