riodwanto / superduper-filament-starter-kit

A Filament💡 starter point to kickstart your app. With Custom Theme, Mail Configuration, Filament Shield, Filament Exception, etc..

A starting point to create your next Filament 3 💡 app. With pre-installed plugins, pre-configured, and custom page. So you don't start all over again.

Features

• 🛡 Filament Shield for managing role access
• 👨🏻‍🦱 customizable profile page from Filament Breezy
• 🌌 Managable media with Filament Spatie Media
• 🖼 Theme settings for changing panel color
• 💌 Setting mail on the fly in Mail settings
• 🅻 Lang Generator
• Etc..

Latest update

Version: v1.14.xx

• New UserResource UI form
• Add avatar to user add & edit
• New Theme settings UI
• Bugs fix & Improvement
• Forgot Password
• User Verification
• Etc

Version Releases

Upcoming:

• Filament Multi Tenancy 🔥
• Add opcodesio/log-viewer for general log viewer
• Member Module
• Some Improvement
• ...

Sadly, Filament Multi-Tenancy will not be included in this starter kit. This repository will focus on improvements for non-multi-tenants, since many rooms should be improved. But, I'll release on different repo for Multi Tenancy usecase. ☕️

Getting Started

Create project with this composer command:

composer create-project riodwanto/superduper-filament-starter-kit

Setup your env:

cd superduper-filament-starter-kit
cp .env.example .env

Run migration & seeder:

php artisan migrate
php artisan db:seed

or

php artisan migrate:fresh --seed

Generate key:

php artisan key:generate

Run :

npm run dev
OR
npm run build

php artisan serve

Now you can access with /admin path, using:

email: [email protected]
password: superadmin

It's recommend to run below command as suggested in Filament Documentation for improving panel perfomance.

php artisan icons:cache

Language Generator

This project include lang generator.

php artisan superduper:lang-translate [from] [to]

Generator will look up files inside folder [from]. Get all variables inside the file; create a file and translate using translate.googleapis.com.

This is what the translation process looks like.

❯ php artisan superduper:lang-translate en fr es

 🔔 Translate to 'fr'
 3/3 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100% -- ✅

 🔔 Translate to 'es'
 1/3 [▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░]  33% -- 🔄 Processing: page.php

Usage example

• Single output

php artisan superduper:lang-translate en fr

• Multiple output

php artisan superduper:lang-translate en es ar fr pt-PT pt-BR zh-CN zh-TW

If you are using json translation

php artisan superduper:lang-translate en fr --json

Plugins

These are Filament Plugins use for this project.

Plugin	Author
Filament Spatie Media Library	Filament Official
Filament Spatie Settings	Filament Official
Filament Spatie Tags	Filament Official
Shield	bezhansalleh
Exceptions	bezhansalleh
Breezy	jeffgreco13
Logger	z3d0x
Ace Code Editor	riodwanto

Plugins Recommendation

Other recommendations for your starter, in my personal opinion:

• Rupadana - API Resources : Generate API for your Resources.
• Bezhan Salleh - Language Switch : Zero config Language Switcher plugin for Filament Panels.
• Kenepa - Resource Lock : Resource locking when other user begins editing a resource.
• Baptiste Bouillot - Jobs monitor : Monitor background jobs.
• Ralph J. Smit - Components : A collection of handy components.
• Tapp Network - Laravel Auditing : Resource locking when other user begins editing a resource.
• Shuvro Roy - Spatie Laravel Health : Health monitoring for Filament.

License

Filament Starter is provided under the MIT License.

If you discover a bug, please open an issue.

superduper-filament-starter-kit's Issues

Missing Role Policy Registration in AuthServiceProvider

Hello Rio,

I've encountered a security issue where the resources of roles can be accessed by any user, including those with lower-level permissions such as authors. This means that an author, who is below an administrator and superadministrator, can access the full CRUD operations (create, edit, assign, delete) for roles.

• To resolve this, it's necessary to include the Role Policy model in the $policies array in the AuthServiceProvider. This will ensure that role permissions are enforced correctly.

Please include the following imports and policy mapping in app\Providers\AuthServiceProvider.php:

<?php
namespace App\Providers;

use App\Policies\RolePolicy; // Add the Role Policy class import
use Spatie\Permission\Models\Role; // Add the Role model import

class AuthServiceProvider extends ServiceProvider
{
    protected $policies = [
        //
        Role::class => RolePolicy::class // Necessary for role permissions to work
    ];
}

This change is essential to restrict access to role management only to users with appropriate permissions.

Thank you for your attention to this matter!

Best regards,
Andre

Failed to update settings.

PHP 8.3

I am so sorry for bothering but i got Failed to update settings. error when save changes in setting page, i installed this kit yet with new released master branch. Please help, thanks

Throwing error 500 when trying to add user.

Hi, thank you for the nice template here.
Though I'm having trouble creating a user
Whenever I try to create a user by pressing add in the user resource I receive Error 500.

Too much loading...

Slow dev environment

Hello! First of all, let me thank you for the starter kit - it is pretty nice and made my day somewhat easier.

However, I'm having a very specific issue regarding loading time of the entire project. Literally everything takes too much time to load. How can I debug or troubleshoot this? Most pages are taking 11s-15s to load.

I haven't made any major changes - I've only updated the locale from en to pt_BR, and even setting it back to en didn't perform any actual changes to the project performance.

Thx!

Filament Shield - Posts, Categories and Exclusions not working

Hi,

Just found another issue, when I create a new role and try to exclude Posts, Categories and Exception it is not working.

For the exception I found that was missing in the app/Providers/AuthServiceProvider the entry Exception::class => ExceptionPolicy::class in the policies, but still not working.

Even tried generating a new policies for all but still not working.

Can you help me identify what I am missing here?

Thanks

Change logo and favicon not success

Terima kasih atas plugin yang keren ini, bang.
I’m consistently encountering a failure when attempting to update the logo and favicon; it results in a ‘404 not found’ error for the logo. It appears that the file in livewire-tmp has been successfully moved, but the filename has not been renamed as expected.
What should I do?

Missing support for translation of json lang files

Hi there, I just want to say what great job you've done with this starter kit, Thank you!
I wish to contribute an implementation of mine for translating JSON lang files based on your work.
I hope you can find some time to review it.

Image not showing

i recently created a fresh project! which to be honest is impressive! kudos to you!
but one slight problem i met is that images are not showing, i linked storage but to no avail! can you help?

Exception when creating a new user

Hi there,

First, nice job on the starter kit.

So I have found that when trying to create a new user I'm getting the below exception.

I currently running on php 8.3.3.

Thanks

readme fix

hi

thanks for your work.

change the description for

Tapp Network - Laravel Auditing : Resource locking when other user begins editing a resource.
Shuvro Roy - Spatie Laravel Health : Resource locking when other user begins editing a resource.

super slow

I still dont know the reason why is so slow i want to login and i have to wait for one minute, i have even disabled xdebug in order to make it a bit faster..

when installing this package, the error happens with laravel/ignition package

PHP version: 8.2

Blog Post Search issue

When searching on a blog post a query error occurred. For details, see this https://flareapp.io/share/pPvBrRoP