chore(readme): update Readme

README.md

@@ -3,46 +3,114 @@
 A fast, modern package manager for Linux systems.
 
 [![Under Development](https://img.shields.io/badge/status-under%20development-orange)](https://github.com/QaidVoid/soar)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 
 > **Note**: Soar is currently under rapid development.
 
 ## 🌟 Features
 
-- **Fast Installation**: Parallel package downloads and installations
-- **Package Management**: Install, remove, update, and list packages effortlessly
-- **Repository Support**: Multiple repository configurations
+- **⚡ Lightning-Fast**: Parallel downloads and installations for maximum speed
+- **🧰 Comprehensive Management**: Easily install, remove, update, and list packages
+- **🌐 Multi-Repository Support**: Configure and use multiple package repositories
+- **🔍 Smart Search**: Quickly find the packages you need
+- **🔄 Effortless Updates**: Keep your system up-to-date with a single command
+- **📊 Detailed Information**: Get in-depth info about installed packages
+- **🏃‍♂️ Run Without Install**: Try packages without permanent installation
 
 ## 🔧 Installation
 
-```bash
+### From Source
+
+1. Clone the repository:
+```sh
+git clone https://github.com/QaidVoid/soar.git
+cd soar
+```
+
+2. Build and install using Cargo:
+```sh
+cargo build --release
 cargo install --path .
 ```
 
+### From Releases
+
+1. Visit the [Releases](https://github.com/QaidVoid/soar/releases) page on GitHub.
+2. Download the latest release for your platform.
+
 ## 🎯 Usage
 
-```bash
+```sh
 Usage: soar [OPTIONS] <COMMAND>
 
 Commands:
-  install  Install packages; supports '--force' flag [aliases: i]
-  search   Search package [aliases: s]
-  query    Query package info [aliases: Q]
-  remove   Remove packages [aliases: r]
-  sync     Sync with remote registry [aliases: S]
-  update   Update packages [aliases: u]
-  info     Show info about installed packages
-  list     List all available packages
-  inspect  Inspect package build log
-  run      Run packages without installing to PATH [aliases: exec]
-  use      Use different variant of a package
-  help     Print this message or the help of the given subcommand(s)
+  install   Install packages [aliases: i]
+  search    Search package [aliases: s]
+  query     Query package info [aliases: Q]
+  remove    Remove packages [aliases: r]
+  sync      Sync with remote registry [aliases: S]
+  update    Update packages [aliases: u]
+  info      Show info about installed packages
+  list      List all available packages
+  inspect   Inspect package build log
+  run       Run packages without installing to PATH [aliases: exec]
+  use       Use different variant of a package
+  download  Download arbitrary files [aliases: dl]
+  health    Health check
+  help      Print this message or the help of the given subcommand(s)
 
 Options:
   -v, --verbose  Unimplemented
   -h, --help     Print help
   -V, --version  Print version
 ```
 
+## ⚙️ Configuration
+
+Soar uses a JSON configuration file located at `~/.config/soar/config.json`.
+
+Default configuration
+```json
+{
+  "soar_path": "$HOME/.soar",
+  "repositories": [
+    {
+      "name": "ajam",
+      "url": "https://bin.ajam.dev",
+      "registry": "METADATA.AIO.json",
+      "sources": {
+        "bin": "https://bin.ajam.dev/x86_64",
+        "pkg": "https://pkg.ajam.dev/x86_64",
+        "base": "https://bin.ajam.dev/x86_64/Baseutils"
+      }
+    }
+  ],
+  "parallel": true,
+  "parallel_limit": 2
+}
+```
+
+### Configuration Fields
+
+- `soar_path`: The path where Soar will store its data.
+
+- `repositories`: Array of package repositories Soar will use to fetch packages.
+  - `name`: A unique name for the repository.
+  - `url`: The main URL of the repository.
+  - `registry`: The filename of the registry metadata file.
+  - `sources`: Specific URLs for different types of content within the repository.
+    - `bin`: URL for downloading binary files.
+    - `pkg`: URL for downloading package files.
+    - `base`: URL for downloading base utility files.
+
+- `parallel`: Boolean flag to enable or disable parallel downloads/installs.
+
+- `parallel_limit`: The maximum number of concurrent downloads/installs when parallel mode is enabled.
+
+You can customize these settings to fit you
+
+
 ## 🤝 Contributing
 
 We welcome contributions! Please feel free to fork the repository and submit
@@ -52,3 +120,4 @@ discuss.
 ## 📝 License
 
 This project is licensed under [MIT] - see the [LICENSE](LICENSE) file for details.
+