README

NativeKit Start Kit NativePHP 1.x, Filament 3.x and Laravel 12.x

About NativeKit

NativeKit is a robust starter kit built on Laravel 12.x, Filament 3.x and NativePHP 1.x, designed to accelerate the development of modern native desktop applications with a ready-to-use multi-panel structure.

Features

• Laravel 12.x - The latest version of the most elegant PHP framework
• Filament 3.x - Powerful and flexible admin framework
• NativePHP 1.x - Build native desktop applications with PHP
• Multi-Panel Structure - Includes three pre-configured panels:
  • Admin Panel (/admin) - For system administrators
  • App Panel (/app) - For authenticated application users
  • Public Panel (frontend interface) - For visitors
• Environment Configuration - Centralized configuration through the config/nativekit.php file

System Requirements

• PHP 8.2 or higher
• Composer
• Node.js and PNPM

Installation

Clone the repository

laravel new my-app --using=jeffersongoncalves/nativekit

Using FilaKit CLI

Or use FilaKit CLI for a simplified setup:

filakit new my-app --kit=jeffersongoncalves/nativekit

Install FilaKit CLI: composer global require jeffersongoncalves/filakit-cli

Easy Installation

Nativekit can be easily installed using the following command:

php install.php

This command automates the installation process by:

• Installing Composer dependencies
• Setting up the environment file
• Generating application key
• Setting up the database
• Running migrations
• Installing Node.js dependencies
• Building assets

Manual Installation

Install JavaScript dependencies

pnpm install

Install Composer dependencies

composer install

Set up environment

cp .env.example .env
php artisan key:generate

Configure your database in the .env file

Run migrations

php artisan migrate

Run the server

php artisan native:serve

Authentication Structure

Nativekit comes pre-configured with a custom authentication system that supports different types of users:

• Admin - For administrative panel access
• User - For application panel access

Development

# Run the development server with logs, queues and asset compilation
composer native:dev

# Or run each component separately
php artisan native:serve
pnpm run dev

Customization

Panel Configuration

Panels can be customized through their respective providers:

• app/Providers/Filament/AdminPanelProvider.php
• app/Providers/Filament/AppPanelProvider.php
• app/Providers/Filament/PublicPanelProvider.php

Alternatively, these settings are also consolidated in the config/nativekit.php file for easier management.

Themes and Colors

Each panel can have its own color scheme, which can be easily modified in the corresponding Provider files or in the nativekit.php configuration file.

Configuration File

The config/nativekit.php file centralizes the configuration of the starter kit, including:

• Panel routes
• Middleware for each panel
• Branding options (logo, colors)
• Authentication guards

Resources

NativeKit includes support for:

• User and admin management
• Multi-guard authentication system
• Tailwind CSS integration
• Database queue configuration
• Customizable panel routing and branding
• Native desktop application development with NativePHP
• Cross-platform compatibility (Windows, macOS, Linux)

License

This project is licensed under the MIT License.

Credits

Developed by Jefferson Gonçalves.