README

About Filamentum

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

Installation

You can install Filamentum in two ways:

1. Via Laravel Installer

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

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

2. Via Composer

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

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

Creating Users

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.

Database Seeding (Recommended)

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

php artisan db:seed

This command creates a complete user management system with:

Three predefined roles:
- Super Admin (full access to all features)
- Admin (access to some admin features)
- User (basic access)
Three corresponding users with the following credentials:

Name	Email	Role	Password
Super Admin User	superadmin@filamentum.com	Super Admin	password
Admin User	admin@filamentum.com	Admin	password
Regular User	user@filamentum.com	User	password

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

Interactive Command (Alternative)

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 Configuration

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.

Panel Path Configuration

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.

Feature Toggles

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)

Configuration File

These settings are defined in config/filamentum.php.

AI Coding Assistance

For developers using AI coding assistants, run the following command to install the MCP server and coding guidelines:

php artisan boost:install

This will set up the Model Context Protocol (MCP) server and configure coding guidelines that enhance your AI-assisted development experience.

Keeping Guidelines Up-to-Date

You may want to periodically update your local AI guidelines to ensure they reflect the latest versions of the Laravel ecosystem packages you have installed. To do so, you can use the boost:update Artisan command:

php artisan boost:update

You may also automate this process by adding it to your Composer "post-update-cmd" scripts:

{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}

Laravel Octane

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

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

Running Tests

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

Installed Packages

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/boost v1 - AI-assisted Laravel development experience
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-activitylog v4 - Activity logging for Laravel
spatie/laravel-backup v9 - Application & database backup tool
spatie/laravel-permission v6 - Roles and permissions management
spatie/laravel-query-builder v6 - Build Eloquent queries from API requests
pestphp/pest v4 - Elegant PHP testing framework
barryvdh/laravel-debugbar v3 - Debug bar for Laravel
barryvdh/laravel-ide-helper v3 - IDE helper files for Laravel

Recommended Additional Packages

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
sentry/sentry-laravel - Error tracking and monitoring

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

License

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

kanekescom / filamentum

Maintainers

Details