PHPackages                             jeddsaliba/filament-one - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. jeddsaliba/filament-one

ActiveProject[Framework](/categories/framework)

jeddsaliba/filament-one
=======================

Filament One is a flexible starter kit for building scalable admin dashboards with essential features, security, and modern PHP practices for a smooth development experience.

1.5.0(3mo ago)9561MITPHPPHP ^8.2

Since Feb 27Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/jeddsaliba/filament-one)[ Packagist](https://packagist.org/packages/jeddsaliba/filament-one)[ RSS](/packages/jeddsaliba-filament-one/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (31)Versions (16)Used By (0)

Filament One
============

[](#filament-one)

**Filament One** is a powerful and flexible starting point for building robust and scalable admin dashboards. This boilerplate is designed to help developers quickly set up an admin panel with essential features, security measures, and user-friendly management tools.

Built using **FilamentPHP**, it leverages modern PHP development practices to ensure a smooth and efficient experience.

[![GitHub stars](https://camo.githubusercontent.com/6a214779a6453065d25f36429b52b3d45db1e48b891cf95cd506d9e93cfc91b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/6a214779a6453065d25f36429b52b3d45db1e48b891cf95cd506d9e93cfc91b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)[![GitHub issues](https://camo.githubusercontent.com/9431f8122d0e56d32a8ef2c263c105cbdae641512b98d7100404b4d6c2ccd312/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/9431f8122d0e56d32a8ef2c263c105cbdae641512b98d7100404b4d6c2ccd312/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)[![GitHub issues](https://camo.githubusercontent.com/fb3344701da59b8da306f2df5138391ef8f2dbdfd6f5657976fab1ad9d41ab9a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/fb3344701da59b8da306f2df5138391ef8f2dbdfd6f5657976fab1ad9d41ab9a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a65646473616c6962612f66696c616d656e742d6f6e653f7374796c653d666c61742d737175617265)[![License](https://camo.githubusercontent.com/7d217ebb91a61cb4d98e70dee31eb08e0a5f71bc518ebd4151a73c6fb1191d00/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/7d217ebb91a61cb4d98e70dee31eb08e0a5f71bc518ebd4151a73c6fb1191d00/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)[![PHP Version](https://camo.githubusercontent.com/ce9f0244725ccf0d07ff15f075982163619c525ae3a126a455c052321643a0f6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322d626c75653f7374796c653d666c61742d737175617265266c6f676f3d706870)](https://camo.githubusercontent.com/ce9f0244725ccf0d07ff15f075982163619c525ae3a126a455c052321643a0f6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322d626c75653f7374796c653d666c61742d737175617265266c6f676f3d706870)[![Laravel Version](https://camo.githubusercontent.com/a8f36014948fbf4a9e26a90578ede3204ff540f82173785e3d8ffc717a6f6e87/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e302d7265643f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)](https://camo.githubusercontent.com/a8f36014948fbf4a9e26a90578ede3204ff540f82173785e3d8ffc717a6f6e87/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e302d7265643f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)[![Filament Version](https://camo.githubusercontent.com/995b9ebb1d0f6772810d48b9cd9837cdeded86f64302a776149aaafd77353756/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d332e322d707572706c653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/995b9ebb1d0f6772810d48b9cd9837cdeded86f64302a776149aaafd77353756/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d332e322d707572706c653f7374796c653d666c61742d737175617265)

**Key Features:**

- **User Management:** Easily manage user accounts, including registration, profile updates, and deletion.
- **Multi-Factor Authentication (MFA):** Enhance security with optional two-factor authentication for user accounts.
- **API Support:** Enable seamless integration with external applications through a robust API layer. Includes authentication, data retrieval, and CRUD operations via RESTful endpoints.
- **API Keys Management:** Enable secure storage and management of API keys and credentials, facilitating seamless integration with internal and third-party APIs.
- **User Roles & Permissions:** Implement role-based access control (RBAC) to ensure users have the right level of access.
- **Messages:** Provides an easy-to-use interface for real-time messaging within Filament admin panels.
- **Export Reports:** Generate and export reports in Excel (.xlsx) or CSV formats for data analysis and record-keeping.
- **Page Builder:** A drag-and-drop interface that allows users to create, customize, and manage pages effortlessly. Supports various content blocks, real-time preview, and responsive design to ensure a seamless experience across devices.

**Why Choose Filament One?**

- **Time-Saving:** Get started quickly with a ready-to-use admin panel instead of building from scratch.
- **Scalability:** Designed to be easily extendable, allowing you to add more features as needed.
- **Security Focused:** Built-in security features like MFA and role-based permissions to protect user data.
- **User-Friendly:** Clean UI and intuitive navigation for a seamless admin experience.
- **Open & Customizable:** Modify and extend the boilerplate according to your project’s requirements.

Table of Contents
-----------------

[](#table-of-contents)

[Setup Local Environment](#local-setup)
[Setup with Docker](#docker-setup)
[Database](#database)
[Generate Filament Shield Permissions](#generate-filament-shield-permissions)
[Create Administrator Account](#create-admin-account)
[Generate Test Data](#generate-test-data)
[Initialize The Application](#initialize-the-application)
[API Support](#api-support)
[Troubleshooting](#troubleshooting)
[Plugins Used](#plugins-used)
[Acknowledgments](#acknowledgments)
[Support](#support)

Setup Local Environment
-----------------------

[](#setup-local-environment)

This section covers setting up Filament One for local development without Docker.

### Prerequisites

[](#prerequisites)

- PHP 8.2 or higher
- Composer
- Node.js 18+ and npm
- MySQL 8.0+ or PostgreSQL 13+
- Redis (optional, for caching and queues)

### Step 1: Create Project and Environment File

[](#step-1-create-project-and-environment-file)

```
# Create project
composer create-project jeddsaliba/filament-one
cd filament-one

# Create environment file
cp .env.example .env
```

### Step 2: Generate Application Key

[](#step-2-generate-application-key)

```
php artisan key:generate
```

### Step 3: Configure Application Settings

[](#step-3-configure-application-settings)

Update the following in your `.env` file:

**Application URL:**

```
APP_NAME="Filament One"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost
APP_TIMEZONE=UTC
```

### Step 4: Configure Database

[](#step-4-configure-database)

**For MySQL:**

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

**For PostgreSQL:**

```
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

**Important:** Make sure you've created the database before running migrations.

### Step 5: Configure Redis (Optional but Recommended)

[](#step-5-configure-redis-optional-but-recommended)

If you have Redis installed locally:

```
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=null
REDIS_DB=0
REDIS_CACHE_DB=1

# Use Redis for cache and sessions
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
```

### Step 6: Configure Mailer

[](#step-6-configure-mailer)

Update mail settings in your `.env` file:

```
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="noreply@example.com"
MAIL_FROM_NAME="${APP_NAME}"
```

**Note:** For local development, you can use [Mailpit](https://github.com/axllent/mailpit) or [MailHog](https://github.com/mailhog/MailHog) for testing emails.

### Step 7: Build Frontend Assets

[](#step-7-build-frontend-assets)

Install npm dependencies and build assets:

```
npm install
npm run build
```

Or for development with hot reload:

```
npm run dev
```

### Next Steps

[](#next-steps)

After completing the setup above, proceed to:

- [Database Migrations](#database)
- [Generate Filament Shield Permissions](#generate-filament-shield-permissions)
- [Create Administrator Account](#create-admin-account)
- [Generate Test Data](#generate-test-data)

Setup with Docker
-----------------

[](#setup-with-docker)

Filament One includes Docker configuration for easy local development. This setup includes PHP-FPM, Nginx, MySQL, Redis, and a queue worker - everything you need to get started quickly.

### Prerequisites

[](#prerequisites-1)

- [Docker Desktop](https://www.docker.com/products/docker-desktop/) installed (includes Docker and Docker Compose)
- At least 4GB of available RAM
- Ports 80, 3306, and 6379 available

### Docker Services Included

[](#docker-services-included)

The Docker setup provides the following services:

ServiceDescriptionPort**app**PHP 8.3-FPM application serverInternal**nginx**Nginx web server80**mysql**MySQL 8.0 database3306**redis**Redis cache and queue6379**queue**Laravel queue workerInternal### Step 1: Create Project and Environment File

[](#step-1-create-project-and-environment-file-1)

```
# Create project
composer create-project jeddsaliba/filament-one
cd filament-one

# Create environment file
cp .env.example .env
```

### Step 2: Configure Docker-Specific Environment Variables

[](#step-2-configure-docker-specific-environment-variables)

**⚠️ Critical:** Docker services communicate using service names as hostnames. Your `.env` file must use these service names.

Update your `.env` file with the following Docker-specific configuration:

```
# Application Settings
APP_NAME="Filament One"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost
APP_TIMEZONE=UTC

# Database Configuration
# ⚠️ DB_HOST must be 'mysql' (Docker service name, not localhost!)
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

# Redis Configuration
# ⚠️ REDIS_HOST must be 'redis' (Docker service name, not localhost!)
REDIS_CLIENT=phpredis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=null
REDIS_DB=0
REDIS_CACHE_DB=1

# Cache & Session (using Redis)
CACHE_STORE=redis
SESSION_DRIVER=redis
SESSION_LIFETIME=120

# Queue Configuration
QUEUE_CONNECTION=redis

# Mail Configuration (optional)
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="noreply@example.com"
MAIL_FROM_NAME="${APP_NAME}"
```

**Important Notes:**

- `DB_HOST=mysql` - Must use the Docker service name, not `127.0.0.1` or `localhost`
- `REDIS_HOST=redis` - Must use the Docker service name, not `127.0.0.1` or `localhost`
- Database credentials (`DB_DATABASE`, `DB_USERNAME`, `DB_PASSWORD`) are used by both Laravel and the MySQL container initialization

### Step 3: Build and Start Docker Containers

[](#step-3-build-and-start-docker-containers)

```
# Build the containers
docker-compose build

# Start all services in detached mode
docker-compose up -d
```

All services should show as "Up" or "running".

### Step 4: Generate Application Key

[](#step-4-generate-application-key)

```
docker-compose exec app php artisan key:generate
```

### Next Steps

[](#next-steps-1)

After completing the Docker setup:

- [Database Migrations](#database)
- [Generate Filament Shield Permissions](#generate-filament-shield-permissions)
- [Create Administrator Account](#create-admin-account)
- [Generate Test Data](#generate-test-data)

### Troubleshooting Docker Setup

[](#troubleshooting-docker-setup)

If you encounter issues, see the [Troubleshooting](#troubleshooting) section below.

Database
--------

[](#database)

### Without Docker

[](#without-docker)

Assuming that you have already created an empty database, run this command to migrate the database tables:

```
php artisan migrate
```

### With Docker

[](#with-docker)

If you're using Docker, the database is automatically created. Just run:

```
docker-compose exec app php artisan migrate
```

Generate Filament Shield Permissions
------------------------------------

[](#generate-filament-shield-permissions)

### Without Docker

[](#without-docker-1)

In order to generate [filament shield](https://filamentphp.com/plugins/bezhansalleh-shield) permissions, run this command:

```
php artisan shield:generate --all
```

### With Docker

[](#with-docker-1)

```
docker-compose exec app php artisan shield:generate --all
```

Create Administrator Account
----------------------------

[](#create-administrator-account)

### Without Docker

[](#without-docker-2)

In order to create an administrator account, run this command:

```
php artisan shield:super-admin
```

### With Docker

[](#with-docker-2)

```
docker-compose exec app php artisan shield:super-admin
```

Generate Test Data
------------------

[](#generate-test-data)

### Without Docker

[](#without-docker-3)

You may also run this command in order to populate the database with test data:

```
php artisan db:seed
```

### With Docker

[](#with-docker-3)

```
docker-compose exec app php artisan db:seed
```

Initialize The Application
--------------------------

[](#initialize-the-application)

### Without Docker

[](#without-docker-4)

**Option 1: Using Vite (Recommended for development)**

```
npm run dev
```

In another terminal, start the PHP server:

```
php artisan serve
```

**Option 2: Build assets for production**

```
npm run build
php artisan serve
```

### With Docker

[](#with-docker-4)

**Start all services:**

```
docker-compose up -d
```

The application will be available at `http://localhost`. The Docker setup includes:

- Nginx web server
- PHP-FPM application server
- Queue worker (runs automatically)
- MySQL database
- Redis cache

**Note:** For frontend development with hot reload, you may want to run Vite separately on your host machine:

```
npm run dev
```

Or use the Docker Node service (if configured) for a fully containerized development environment.

API Support
-----------

[](#api-support)

Integrate **Filament One** with external applications via APIs.
[Here](https://github.com/jeddsaliba/filament-one/blob/8b79bf5f4108b9c0f20fac1a2156604259b91a16/docs/postman/Filament%20One%20API.postman_collection.json) is the [postman](https://www.postman.com) collection. Just import it and you're all set!

Troubleshooting
---------------

[](#troubleshooting)

### CSS and JS not working

[](#css-and-js-not-working)

**Without Docker:**

```
npm run build
```

**With Docker:**

```
docker-compose exec app npm run build
```

Or rebuild the assets in the container:

```
docker-compose exec app sh -c "npm install && npm run build"
```

Plugins Used
------------

[](#plugins-used)

These are [Filament Plugins](https://filamentphp.com/plugins) use for this project.

**Plugin****Author**[Ace Editor](https://github.com/riodwanto/filament-ace-editor)[Rio Dewanto P](https://github.com/riodwanto)[ActivityLog](https://github.com/rmsramos/activitylog)[Rômulo Ramos](https://github.com/rmsramos)[API Service](https://github.com/rupadana/filament-api-service)[Rupadana](https://github.com/rupadana)[Breezy](https://github.com/jeffgreco13/filament-breezy)[Jeff Greco](https://github.com/jeffgreco13)[Comments](https://github.com/parallax/filament-comments)[Parallax](https://github.com/parallax)[Date Range Filter and Picker](https://github.com/malzariey/filament-daterangepicker-filter)[Majid Al Zariey](https://github.com/malzariey)[Easy Footer](https://github.com/devonab/filament-easy-footer)[Alexandre](https://github.com/Devonab)[Environment Indicator](https://github.com/pxlrbt/filament-environment-indicator)[Dennis Koch](https://github.com/pxlrbt)[Filament Spatie Media Library](https://github.com/filamentphp/spatie-laravel-media-library-plugin)[Filament Official](https://github.com/filamentphp)[Filament Spatie Settings](https://github.com/filamentphp/spatie-laravel-settings-plugin)[Filament Official](https://github.com/filamentphp)[Global Search Modal](https://github.com/CharrafiMed/global-search-modal)[Mohamed Charrafi](https://github.com/CharrafiMed)[Grapes JS](https://github.com/dotswan/filament-grapesjs-v3)[dotSwan](https://github.com/dotswan)[Impersonate](https://github.com/stechstudio/filament-impersonate)[Signature Tech Studio](https://github.com/stechstudio)[Phone Input](https://github.com/ysfkaya/filament-phone-input)[Yusuf Kaya](https://github.com/ysfkaya)[Shield](https://github.com/bezhanSalleh/filament-shield)[Bezhan Salleh](https://github.com/bezhansalleh)[Spatie Laravel Health](https://github.com/shuvroroy/filament-spatie-laravel-health)[Shuvro Roy](https://github.com/shuvroroy)

Acknowledgments
---------------

[](#acknowledgments)

- [FilamentPHP](https://filamentphp.com)
- [Laravel](https://laravel.com)

Support
-------

[](#support)

- [Report a bug](https://github.com/jeddsaliba/filament-one/issues)
- [Request a feature](https://github.com/jeddsaliba/filament-one/issues)
- [Email support](mailto:jeddsaliba@gmail.com)

Show Your Support
-----------------

[](#show-your-support)

Give a ⭐️ if this project helped you!

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance78

Regular maintenance activity

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Recently: every ~77 days

Total

14

Last Release

115d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b559eadc57e518a855212ca3c95827b9ed955c09b143490c82ba11d3e81e63e8?d=identicon)[jeddsaliba](/maintainers/jeddsaliba)

---

Top Contributors

[![jeddsaliba](https://avatars.githubusercontent.com/u/27769176?v=4)](https://github.com/jeddsaliba "jeddsaliba (17 commits)")

---

Tags

frameworklaravelfilamentstarter-kitadmin-panel

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeddsaliba-filament-one/health.svg)

```
[![Health](https://phpackages.com/badges/jeddsaliba-filament-one/health.svg)](https://phpackages.com/packages/jeddsaliba-filament-one)
```

###  Alternatives

[siubie/kaido-kit

Filament Admin Panel Starter Kit with pre-configured packages and settings

3824.9k](/packages/siubie-kaido-kit)[raugadh/fila-starter

Laravel Filament Starter.

614.9k](/packages/raugadh-fila-starter)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)[ercogx/laravel-filament-starter-kit

This is a Filament v3 Starter Kit for Laravel 12, designed to accelerate the development of Filament-powered applications.

401.5k](/packages/ercogx-laravel-filament-starter-kit)[openclassify/openclassify

The skeleton application for the Laravel framework.

2992.5k](/packages/openclassify-openclassify)[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)