Best-Locator

AI-powered selector generator with framework-aware intelligence for seamless cross-platform testing.

Navigate organically, capture selectively, test intelligently.

🚀 Quick Start

# Install and start in 30 seconds
npm install -g bestlocator && npx playwright install

# Web: Professional toggle mode with React intelligence
bestlocator pick-toggle https://your-app.com --ai --stack react

# Mobile: Visual inspector for apps  
bestlocator mobile-inspector app.apk android

✨ Why Choose Best-Locator?

🏗️ Framework-Aware Intelligence (Industry First)

Generates React-optimized getByTestId() instead of fragile CSS classes. Supports React, Vue, Angular, ASP.NET, and more.

🎛️ Professional Toggle Mode

Cross-page sessions let you navigate login flows and capture elements across multiple pages in one workflow.

📱 Web + Mobile

Same intuitive workflow for web apps and mobile apps. Visual mobile inspector at localhost:8100.

🧠 AI-Enhanced

Hybrid AI (GPT-4/Ollama) + rules for reliable, semantic selectors with explanations.

🆚 vs. Competition

| Feature | Best-Locator | Others | |---------|:------------:|:------:| | Framework-Aware | ✅ React/Vue/Angular | ❌ Generic CSS | | Cross-Page Sessions | ✅ Login flows | ❌ Single page | | Mobile Apps | ✅ Visual inspector | ❌ Web only | | AI-Powered | ✅ Context-aware | ❌ Rule-based |

🛠️ Framework & Platform Support

| Category | Supported | |:------------:|:--------------| | Web Frameworks | Playwright, Selenium, Cypress, TestCafe, WebdriverIO | | Mobile Platforms | Android, iOS (via Appium) | | Languages | JavaScript, TypeScript, Python, Java, C# | | Technology Stacks | React, Vue, Angular, ASP.NET, Svelte, Lit, Vanilla JS |

📚 Documentation

| Getting Started | Advanced | Development | |:-------------------:|:------------:|:---------------:| | Installation & Setup | Framework-Aware Guide | Development Guide | | Basic Usage | Mobile Inspector | Testing Guide | | Troubleshooting | AI Configuration | Architecture |

📖 Complete Wiki • 🐛 Issues • 💬 Discussions

💡 Professional Use Cases

# E-commerce: Navigate checkout flow, capture all form elements
bestlocator pick-toggle https://shop.com --stack react --ai

# Enterprise: Multi-page admin workflow with Angular
bestlocator pick-toggle https://admin.com --stack angular --ai

# Mobile: Visual testing without DOM inspection
bestlocator mobile-inspector banking-app.apk android

⚡ Quick Commands

bestlocator hello                    # Verify installation
bestlocator init                     # Create config file
bestlocator ai-test                  # Test AI providers
bestlocator pick <url> --stack react # Quick selector

📄 License

MIT License © Jonathan Gonzalez

🚀 Get Started • ⭐ Star this repo • 📚 Read the Docs