PHPackages subodh/smart-ai-assistant - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. subodh/smart-ai-assistant ActiveLibrary[Utility & Helpers](/categories/utility) subodh/smart-ai-assistant ========================= A reusable Laravel package providing a smart AI assistant for AEPS error handling. v1.0.0(5mo ago)01MITJavaScriptPHP >=8.1 Since Dec 8Pushed 3mo agoCompare [ Source](https://github.com/ksubodh9/smart-ai-assistant)[ Packagist](https://packagist.org/packages/subodh/smart-ai-assistant)[ RSS](/packages/subodh-smart-ai-assistant/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (2)Versions (3)Used By (0) Smart AI Assistant v2.0 ======================= [](#smart-ai-assistant-v20) > A modern, intelligent chat assistant for Laravel applications with automatic error detection, file attachments, and bilingual support. [![Version](https://camo.githubusercontent.com/dd1b51eac051b316a3173585bc64d36e19fa2d4e90a4581734cc292c175130f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d322e302e302d626c75652e737667)](CHANGELOG.md)[![Laravel](https://camo.githubusercontent.com/17c62ff65a5f3a19d1f9eb6880bfd356415db0dcfae4b04699ec36b98cd94ab0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382e782532422d7265642e737667)](https://laravel.com)[![License](https://camo.githubusercontent.com/c839a7f94c0fe29188d38c775e0a44060f8e4c5d328e1aa42797f0fa9507e7ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d50726f70726965746172792d677265656e2e737667)](LICENSE) --- ๐ŸŒŸ Features ---------- [](#-features) - โœ… **Auto Error Detection** - Automatically scans pages for errors - โœ… **Clickable Error Tags** - Interactive chips for found errors - โœ… **Modern Chat UI** - WhatsApp/ChatGPT-inspired design - โœ… **File Attachments** - Upload images, PDFs, and documents - โœ… **Fullscreen Preview** - View attachments in fullscreen modal - โœ… **Bilingual Support** - English and Hindi responses - โœ… **Typing Indicators** - Animated dots while waiting - โœ… **Smart Context** - Includes error context in queries - โœ… **Responsive Design** - Works on mobile and desktop - โœ… **Smooth Animations** - Professional transitions and effects --- ๐Ÿ“ธ Screenshots ------------- [](#-screenshots) See the visual mockups showing the modern, premium design! --- ๐Ÿš€ Quick Start ------------- [](#-quick-start) ### Installation [](#installation) This package is already installed in your Laravel application. ### Deployment [](#deployment) ``` # Clear caches php artisan cache:clear php artisan view:clear # Publish assets php artisan vendor:publish --tag=smart-ai-assistant-assets --force php artisan vendor:publish --tag=smart-ai-assistant-views --force # Hard refresh browser # Ctrl + Shift + R ``` ### Usage [](#usage) Add the widget to any Blade template: ``` ``` That's it! The assistant will appear as a floating button in the bottom-right corner. --- ๐Ÿ“š Documentation --------------- [](#-documentation) DocumentDescription**[UPGRADE\_SUMMARY.md](UPGRADE_SUMMARY.md)**Complete upgrade overview**[DEPLOYMENT\_GUIDE.md](DEPLOYMENT_GUIDE.md)**Step-by-step deployment**[README\_UPGRADE.md](README_UPGRADE.md)**Feature documentation**[ARCHITECTURE.md](ARCHITECTURE.md)**System architecture**[QUICK\_REFERENCE.md](QUICK_REFERENCE.md)**Developer quick reference**[CHANGELOG.md](CHANGELOG.md)**Version history--- ๐ŸŽฏ How It Works -------------- [](#-how-it-works) ### 1. Panel Opens [](#1-panel-opens) - Shows welcome message: "Hello! I'm Soniya" - Automatically scans page for errors - Displays status: "Scanning your page..." ### 2. Error Detection [](#2-error-detection) - Scans for: `.alert-danger`, `.invalid-feedback`, `.text-danger`, `.smart-error` - Displays errors as clickable tags - Shows warning icon (โš ๏ธ) ### 3. User Interaction [](#3-user-interaction) - Click error tag โ†’ Sends to API โ†’ Shows AI response - Or type manual message โ†’ Send to support - Attach files for context ### 4. AI Response [](#4-ai-response) - Returns English and Hindi solutions - Displays in chat bubble format - Auto-scrolls to bottom --- ๐ŸŽจ Customization --------------- [](#-customization) ### Change Colors [](#change-colors) Edit `public/css/assistant.css`: ``` #smart-assistant-toggle { background: linear-gradient(135deg, #YOUR_COLOR_1 0%, #YOUR_COLOR_2 100%); } ``` ### Change Assistant Name [](#change-assistant-name) Edit `resources/views/components/widget.blade.php`: ``` Hello! I'm YOUR_NAME ``` ### Add Error Selectors [](#add-error-selectors) Edit `public/js/assistant.js`: ``` const errorSelectors = [ '.alert-danger', '.your-custom-selector' ]; ``` --- ๐Ÿ”ง API Endpoints --------------- [](#-api-endpoints) ### Error Query [](#error-query) ``` POST /smart-assistant/help ``` **Request:** ``` { "error_text": "Error message", "page_url": "https://example.com" } ``` **Response:** ``` { "answer_en": "English solution", "answer_hi": "Hindi solution", "source": "known" } ``` ### Chat Message [](#chat-message) ``` POST /customer-support/raise/ticket ``` **FormData:** - `maddox_id`: User ID - `description`: Message text - `attachment`: File (optional) --- ๐Ÿ“ File Structure ---------------- [](#-file-structure) ``` packages/smart-ai-assistant/ โ”œโ”€โ”€ public/ โ”‚ โ”œโ”€โ”€ css/ โ”‚ โ”‚ โ””โ”€โ”€ assistant.css โ”‚ โ””โ”€โ”€ js/ โ”‚ โ”œโ”€โ”€ ui-manager.js โ”‚ โ”œโ”€โ”€ api-manager.js โ”‚ โ”œโ”€โ”€ file-preview.js โ”‚ โ””โ”€โ”€ assistant.js โ”œโ”€โ”€ resources/ โ”‚ โ””โ”€โ”€ views/ โ”‚ โ””โ”€โ”€ components/ โ”‚ โ””โ”€โ”€ widget.blade.php โ”œโ”€โ”€ src/ โ”‚ โ”œโ”€โ”€ Http/ โ”‚ โ”‚ โ””โ”€โ”€ Controllers/ โ”‚ โ”œโ”€โ”€ Models/ โ”‚ โ””โ”€โ”€ SmartAiAssistantServiceProvider.php โ”œโ”€โ”€ config/ โ”‚ โ””โ”€โ”€ smart-ai-assistant.php โ”œโ”€โ”€ database/ โ”‚ โ””โ”€โ”€ migrations/ โ””โ”€โ”€ routes/ โ””โ”€โ”€ web.php ``` --- ๐Ÿงช Testing --------- [](#-testing) ### Manual Testing Checklist [](#manual-testing-checklist) - Panel opens with welcome message - Error scanning detects errors - Error tags are clickable - Chat messages display correctly - File attachment works - Fullscreen preview opens - Send button works - API responses display - Mobile responsive works - No console errors ### Browser Testing [](#browser-testing) - Chrome 90+ - Firefox 88+ - Safari 14+ - Edge 90+ - Mobile browsers --- ๐Ÿ› Troubleshooting ----------------- [](#-troubleshooting) ### Changes not appearing? [](#changes-not-appearing) 1. Clear all Laravel caches 2. Republish assets with `--force` 3. Hard refresh browser ### JavaScript errors? [](#javascript-errors) 1. Check all 4 JS files are loaded 2. Verify load order in widget.blade.php 3. Check browser console ### Styles not applying? [](#styles-not-applying) 1. Verify CSS file is loaded 2. Check for CSS conflicts 3. Inspect elements in DevTools See [DEPLOYMENT\_GUIDE.md](DEPLOYMENT_GUIDE.md) for more troubleshooting tips. --- ๐Ÿ“Š Version History ----------------- [](#-version-history) ### v2.0.0 (2025-12-04) [](#v200-2025-12-04) - Complete UI/UX overhaul - Modular JavaScript architecture - File attachment system - Fullscreen preview modal - Modern chat interface - Comprehensive documentation ### v1.0.0 (2025-11-29) [](#v100-2025-11-29) - Initial release - Basic error detection - Simple chat interface See [CHANGELOG.md](CHANGELOG.md) for detailed history. --- ๐Ÿ—๏ธ Architecture --------------- [](#๏ธ-architecture) ### Modular Design [](#modular-design) - **ui-manager.js** - UI interactions and state - **api-manager.js** - Backend communications - **file-preview.js** - File handling and preview - **assistant.js** - Main controller ### Data Flow [](#data-flow) ``` User Action โ†’ UI Manager โ†’ API Manager โ†’ Backend โ†“ โ†“ Update UI โ† Parse Response ``` See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed diagrams. --- ๐ŸŽ“ Learning Resources -------------------- [](#-learning-resources) ### For Developers [](#for-developers) 1. Start with [QUICK\_REFERENCE.md](QUICK_REFERENCE.md) 2. Study [ARCHITECTURE.md](ARCHITECTURE.md) 3. Review code comments in JS files ### For Designers [](#for-designers) 1. Review [assistant.css](public/css/assistant.css) 2. Check color palette in docs 3. Inspect animations ### For Testers [](#for-testers) 1. Follow testing checklist above 2. Test on multiple browsers 3. Test error scenarios --- ๐Ÿค Contributing -------------- [](#-contributing) This is a proprietary package for Maddox Pay. Internal contributions welcome. ### Development Workflow [](#development-workflow) 1. Make changes in `packages/smart-ai-assistant/` 2. Test locally 3. Publish assets 4. Test in browser 5. Document changes --- ๐Ÿ“„ License --------- [](#-license) Proprietary - Maddox Pay --- ๐Ÿ‘ฅ Credits --------- [](#-credits) **Developed for:** Maddox Pay **Version:** 2.0.0 **Last Updated:** December 4, 2025 --- ๐Ÿ“ž Support --------- [](#-support) For issues or questions: 1. Check documentation files 2. Review troubleshooting section 3. Check browser console 4. Contact development team --- ๐ŸŽฏ Roadmap --------- [](#-roadmap) ### Future Enhancements [](#future-enhancements) - Voice input support - Multi-language support (beyond EN/HI) - Advanced analytics - Custom themes - Keyboard shortcuts - Search history - Export chat history --- ๐ŸŒŸ Why Choose Smart AI Assistant? -------------------------------- [](#-why-choose-smart-ai-assistant) ### Before [](#before) - Basic error detection - Simple UI - Limited functionality - No file support - Minimal documentation ### After (v2.0) [](#after-v20) - โœ… Advanced error detection with tags - โœ… Modern, premium UI - โœ… Full file attachment system - โœ… Fullscreen previews - โœ… Comprehensive documentation - โœ… Mobile responsive - โœ… Smooth animations - โœ… Bilingual support --- **Ready to get started?** Check out [DEPLOYMENT\_GUIDE.md](DEPLOYMENT_GUIDE.md)! --- *Built with โค๏ธ for Maddox Pay* *Powered by Maddox AI* ### Health Score 33 โ€” LowBetter than 75% of packages Maintenance76 Regular maintenance activity Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 155d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/007ef4f1e51bf1b745b8fc20693d6baeb102e1135f5d9e742d5856da8135322e?d=identicon)[ksubodh9](/maintainers/ksubodh9) --- Top Contributors [![ksubodh9](https://avatars.githubusercontent.com/u/121888806?v=4)](https://github.com/ksubodh9 "ksubodh9 (1 commits)") ### Embed Badge ![Health badge](/badges/subodh-smart-ai-assistant/health.svg) ``` [![Health](https://phpackages.com/badges/subodh-smart-ai-assistant/health.svg)](https://phpackages.com/packages/subodh-smart-ai-assistant) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[illuminate/pipeline The Illuminate Pipeline package. 9446.6M213](/packages/illuminate-pipeline)[illuminate/pagination The Illuminate Pagination package. 10532.5M862](/packages/illuminate-pagination)[spatie/laravel-mix-preload Add preload and prefetch links based your Mix manifest 169176.0k2](/packages/spatie-laravel-mix-preload)[mrmarchone/laravel-auto-crud Laravel Auto CRUD helps you streamline development and save time. 28711.8k2](/packages/mrmarchone-laravel-auto-crud)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 17221.0k3](/packages/interaction-design-foundation-laravel-geoip) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)