chore(docs): update README with documentation link and standard package structure

Author: officialmeritinfos

README.md

@@ -1,23 +1,88 @@
 # AuthKit
+
 ![Tests](https://github.com/Xultech-LTD/auth-kit/actions/workflows/tests.yml/badge.svg)
 ![License](https://img.shields.io/github/license/Xultech-LTD/auth-kit)
-![PHP](https://img.shields.io/badge/php-%5E8.2-blue)
-![Laravel](https://img.shields.io/badge/laravel-12-red)
-![Laravel](https://img.shields.io/badge/laravel-13-green)
+![PHP](https://img.shields.io/badge/php-%5E8.3-blue)
+![Laravel](https://img.shields.io/badge/laravel-12.x-red)
+![Laravel](https://img.shields.io/badge/laravel-13.x-green)
+
+AuthKit is a reusable, configuration-driven authentication package for Laravel applications.
+
+It provides a complete authentication system with Blade-based UI, flexible configuration, and extensible flows — without forcing a fixed implementation.
+
+---
+
+## 🚀 Documentation
+
+Full documentation is available here:
 
-Reusable Laravel auth kit package with Blade UI, themes, email verification, two-factor authentication, password reset, and rate limiting.
+👉 **https://xultech-ltd.github.io/auth-kit/**
 
-## Status
+The documentation covers:
 
-AuthKit is currently in active development and not yet published to Packagist.
+- Installation
+- Configuration
+- Authentication flows
+- UI customization
+- Extensibility and overrides
+- Security features
 
-## Features
+---
 
-- Login / registration
-- Email verification (link or token)
-- Password reset (link or token)
-- Two-factor authentication(TOTP supported - able to extend)
+## ✨ Features
+
+- Authentication (login & registration)
+- Email verification (link or token-based)
+- Password reset (link or token-based)
+- Two-factor authentication (TOTP, extensible drivers)
 - Blade-based UI components
-- Theme support
-- Rate limiting configuration
-- Controller and validation overrides
+- Theme and UI customization support
+- Fully configuration-driven architecture
+- Route, controller, and validation overrides
+- Rate limiting and security controls
+
+---
+
+## 📦 Installation
+
+> ⚠️ AuthKit is currently in active development.
+
+Once published:
+
+```bash
+composer require xul/auth-kit
+```
+Then follow the installation guide in the documentation.
+
+## ⚙️ Configuration Philosophy
+
+AuthKit is built around a configuration-first approach.
+
+Instead of hardcoding behavior, you can control:
+
+- authentication flows 
+- route structure and naming 
+- validation and payload mapping 
+- UI rendering and form schemas 
+- security features (verification, 2FA, confirmations)
+- frontend behavior and themes
+
+This allows you to adapt AuthKit to your application without modifying package internals.
+
+## 🧪 Testing
+```bash
+composer test
+```
+
+## 🤝 Contributing
+
+Contributions are welcome.
+
+Please:
+- open issues for bugs or feature requests 
+- submit pull requests for improvements 
+- follow existing code style and structure
+
+- ## 📄 License
+
+AuthKit is open-sourced software licensed under the MIT license.

composer.json

@@ -30,10 +30,18 @@
   ],
   "require": {
     "php": "^8.3",
-    "illuminate/support": "^12.0|^13.0",
+    "illuminate/auth": "^12.0|^13.0",
+    "illuminate/cache": "^12.0|^13.0",
+    "illuminate/contracts": "^12.0|^13.0",
+    "illuminate/events": "^12.0|^13.0",
+    "illuminate/http": "^12.0|^13.0",
+    "illuminate/notifications": "^12.0|^13.0",
+    "illuminate/queue": "^12.0|^13.0",
     "illuminate/routing": "^12.0|^13.0",
+    "illuminate/session": "^12.0|^13.0",
+    "illuminate/support": "^12.0|^13.0",
+    "illuminate/validation": "^12.0|^13.0",
     "illuminate/view": "^12.0|^13.0",
-    "livewire/blaze": "^1.0",
     "bacon/bacon-qr-code": "^3.0"
   },
   "require-dev": {

docs/.vitepress/config.mjs

@@ -9,7 +9,6 @@ export default defineConfig({
         nav: [
             { text: 'Home', link: '/' },
             { text: 'Installation', link: '/installation' },
-            { text: 'Architecture', link: '/architecture/overview' },
             { text: 'GitHub', link: 'https://github.com/Xultech-LTD/auth-kit' }
         ],