Update README.md

Author: milwad-dev

README.md

@@ -7,3 +7,45 @@
 [![Total Downloads](https://img.shields.io/packagist/dt/binafy/laravel-score.svg?style=flat-square)](https://packagist.org/packages/binafy/laravel-score)
 [![License](https://img.shields.io/packagist/l/binafy/laravel-score)](https://packagist.org/packages/binafy/laravel-score)
 [![Passed Tests](https://github.com/binafy/laravel-score/actions/workflows/tests.yml/badge.svg)](https://github.com/binafy/laravel-score/actions/workflows/tests.yml)
+
+## Introduction
+
+A comprehensive Laravel package to implement scoring systems effortlessly. Whether you're building leaderboards, calculating performance metrics, or managing gamification features, Laravel Score provides an intuitive API to define, calculate, and manage scores seamlessly. Perfect for applications requiring dynamic and flexible scoring mechanisms.
+
+## Key Features:
+
+- Simple integration with Eloquent models.
+- Support for customizable scoring rules.
+- Designed for performance and scalability.
+- Extensible and developer-friendly.
+
+## Installation
+
+You can install the package with Composer.
+
+```shell
+composer require binafy/laravel-score
+```
+
+## Publish
+
+If you want to publish a config file you can use this command:
+
+```shell
+php artisan vendor:publish --tag="laravel-score-config"
+```
+
+If you want to publish the migrations you can use this command:
+
+```shell
+php artisan vendor:publish --tag="laravel-score-migrations"
+```
+
+For convenience, you can use this command to publish config, migration, and ... files:
+
+```shell
+php artisan vendor:publish --provider="Binafy\LaravelScore\Providers\LaravelScoreServiceProvider"
+```
+
+After publishing, run the `php artisan migrate` command.
+