Skip to content

A Laravel starter kit with Filament for panels, persian language, persian validation, vazirmatn font, and essential features for rapid application development.

Notifications You must be signed in to change notification settings

sadegh19b/Filar

Repository files navigation

Filar

A starter kit for Laravel included Filament for panels, Persian language, Vazirmatn font, and essential features for rapid application development.

🚀 Features

  • Laravel 12.x
  • Filament 3.x
  • Livewire 3.x
  • TailwindCSS 4.x
  • Laravel Pint
  • Laravel Rector
  • Larastan
  • Laravel Persian Language
  • Vazirmatn Font

📦 Installation & Usage

First, you must clone the repo:

git clone https://github.com/sadegh19b/Filar.git
cd Filar

For local development with docker, you can use the following commands:

docker compose up -d --build
docker exec -it filar-app-dev-1 bash
composer i
cp .env.dev .env
php artisan key:generate
npm i && npm run dev

For local development without docker, you can use the following commands:

composer i
cp .env.dev .env
php artisan key:generate
npm i
composer run dev

🏗 Extra Features

You can add extra features with installing packages if needed to the project.

  • Laravel Debugbar: for debugging the project.

    composer require barryvdh/laravel-debugbar --dev
  • Laravel Persian Language: for persian language translation files.

    composer require sadegh19b/laravel-persian-lang
  • Laravel Persian Validation: for persian language validation rules.

    composer require sadegh19b/laravel-persian-validation
  • Laravel Iran Cities: for iran cities migration & seeder files.

    composer require sadegh19b/laravel-iran-cities
  • Laravel Persian Faker: for persian language faker data.

    composer require amyavari/persian-faker-php

📝 Notes

  • For better performance, suggest to use the below commands to cache icons and components:

    php artisan icons:cache
    php artisan filament:cache-components
  • Always use pint & rector after any changes in the codebase for formatting the code and use phpstan for static analysis with the following commands:

    composer run pint
    composer run rector
    composer run phpstan
  • You can use the google fonts for Vazirmatn font:

    <link href='https://fonts.googleapis.com/css?family=Vazirmatn' rel='stylesheet' />

    Or use the font from the public/css/fonts/vazirmatn.css file, for filament or views.

🔀 Git

Commit Messages

For commit messages, use the following conventional commits, please read it before starting to work.

Git Flow

We use the git flow branching model, please read it before starting to work.

If you want to ignore permission changes to git in the project, you can use the following command:

git config core.fileMode false

or globally:

git config --global core.fileMode false

📚 Documentation

📄 License

This project is licensed under the MIT License.

About

A Laravel starter kit with Filament for panels, persian language, persian validation, vazirmatn font, and essential features for rapid application development.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Languages