Filamentum is a Laravel starter kit with the Filament admin panel and essential packages pre-installed.

• Dashboard
• Users management
• Roles management

• Laravel Debugbar for debugging assistance
• Laravel Telescope for monitoring and debugging

• Laravel Sail for containerized development
• Laravel Octane for high-performance serving

You can install Filamentum in two ways:

Create a new project using Laravel installer with Filamentum as the starter kit:

laravel new my-app --using=kanekescom/filamentum

Note: For more information about Laravel Installer, please refer to the official Laravel Installer documentation.

You can install Filamentum in two ways:

a. Using Composer Create-Project:

composer create-project kanekescom/filamentum my-app

b. Clone from GitHub:

git clone https://github.com/kanekescom/filamentum.git my-app
cd my-app
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate

After installation, your application will be ready with all the essential packages and configurations set up.

These settings are defined in config/filamentum.php.

To access the Filament admin panel, you'll need to create user accounts. The recommended approach is to use database seeding which creates predefined users with specific roles.

Run the following command to create default users with predefined roles:

php artisan db:seed

This command creates a complete user management system with:

1. Three predefined roles:

   • Super Admin (can access Dashboard, Users, and Roles)
   • Admin (can access Dashboard and Users)
   • User (can only access Dashboard)

2. Three corresponding users with the following credentials:

Once created, you can log in to the admin panel at /app using any of these credentials.

If you prefer to create individual users interactively, you can use:

php artisan make:filament-user

This command will prompt you to enter the user's name, email, and password. Note that users created this way will need to be manually assigned roles and permissions.

Filamentum provides several configuration options that allow you to customize the admin panel behavior. These settings can be configured through environment variables in your .env file.

You can change the URL path for the Filament admin panel:

FILAMENTUM_PATH=app

The default path is app, which makes the admin panel accessible at /app. You can change this to any path you prefer, such as admin or dashboard.

Filamentum allows you to enable or disable various authentication features:

FILAMENTUM_REGISTRATION=true
FILAMENTUM_PASSWORD_RESET=true
FILAMENTUM_EMAIL_VERIFICATION=true
FILAMENTUM_EMAIL_CHANGE_VERIFICATION=true
FILAMENTUM_PROFILE=true

• FILAMENTUM_REGISTRATION: Enable or disable user registration (default: false)
• FILAMENTUM_PASSWORD_RESET: Enable or disable password reset functionality (default: false)
• FILAMENTUM_EMAIL_VERIFICATION: Enable or disable email verification (default: false)
• FILAMENTUM_EMAIL_CHANGE_VERIFICATION: Enable or disable email change verification (default: false)
• FILAMENTUM_PROFILE: Enable or disable user profile management (default: true)

This project comes with Laravel Sail pre-installed for Docker-based development environments. To get started with Sail, you'll need to have Docker installed on your system.

After installing Docker, you can start the Sail environment with:

./vendor/bin/sail up

Once the containers are up, you can access your application in your web browser at http://localhost.

For more information about Laravel Sail configuration and usage, please refer to the official Laravel Sail documentation.

This project comes with Laravel Octane pre-installed for high-performance serving of your Laravel application. To use Octane with FrankenPHP (the default server for this project), you need to run the installation command:

php artisan octane:install

When prompted, select "frankenphp" as your server.

After installation, you can start your application using Octane with:

php artisan octane:start

Note: For more information about Laravel Octane configuration and usage, please refer to the official Laravel Octane documentation.

Before running tests, copy the PHPUnit configuration template:

cp phpunit.xml.dist phpunit.xml

The phpunit.xml file is gitignored, allowing you to add custom environment variables (such as API credentials) without committing them to the repository.

You can run the test suite using Composer:

composer test

This will execute all tests using PestPHP, which is configured as the default testing framework for this project.

Alternatively, you can run tests directly using the Artisan command:

php artisan test

Filamentum comes with several pre-installed packages to help you build your application:

• laravel/framework v12 - The core Laravel framework
• laravel/octane v2 - High-performance Laravel application server
• laravel/sail v1 - Docker setup for Laravel applications
• laravel/telescope v5 - Debug assistant for Laravel
• filament/filament v4 - Admin panel & app UI framework
• bezhansalleh/filament-shield v4 - Role & permission management
• spatie/laravel-permission v6 - Roles and permissions management
• barryvdh/laravel-debugbar v3 - Debug bar for Laravel

To further enhance your Laravel application, consider adding these recommended packages:

• laravel/horizon - Dashboard for Laravel queues
• laravel/nightwatch - Application monitoring tool
• laravel/passport - OAuth2 server for API authentication
• laravel/sanctum - Authentication for SPAs and APIs
• laravel/socialite - OAuth authentication with social networks
• barryvdh/laravel-ide-helper v3 - IDE helper files for Laravel

Refer to each package's documentation for specific installation and configuration instructions.

Filamentum is open-sourced software licensed under the MIT license.