jeffersongoncalves / nativekit
The skeleton application for NativePHP, FilamentPHP and Laravel - Build native desktop applications.
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 0
Forks: 0
Open Issues: 0
Type:project
Requires
- php: ^8.2
- filament/filament: 3.3.32
- laravel/framework: ^12.0
- laravel/tinker: ^2.10.1
- livewire/livewire: ^3.6
- nativephp/electron: ^1.1
Requires (Dev)
- barryvdh/laravel-ide-helper: ^3.5
- fakerphp/faker: ^1.23
- larastan/larastan: ^3.2
- laravel/pail: ^1.1
- laravel/pint: ^1.13
- laravel/sail: ^1.26
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.1
- pestphp/pest: ^3.7
- pestphp/pest-plugin-laravel: ^3.0
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
- Admin Panel (
- 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
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 accessUser
- 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.