A conversational AI platform that helps customers find and compare product prices based on their location. Built with Laravel 12 and React 18, AskMe provides ChatGPT-style price inquiry through intelligent location-based comparisons.
- ChatGPT-style chat experience for natural price inquiries
- Multi-session chat management for organized conversations
- Streaming responses for real-time interaction
- Automatic location detection and filtering
- Geographic price comparisons from nearby retailers
- Privacy-conscious location handling
- LLM-powered product price research
- Comparative analysis across multiple sources
- Real-time pricing data integration
- Light/dark mode support with smooth transitions
- Fully responsive design for all devices
- Accessible interface following WCAG guidelines
- Built with Shadcn/ui design system
- Backend: Laravel 12.x with PHP 8.3+
- Frontend: React 18 with TypeScript (strict mode)
- SPA Integration: Inertia.js v2 for seamless Laravel-React communication
- Database: MySQL with optimized indexing for location-based queries
- UI Framework: Shadcn/ui (Radix UI + Tailwind CSS v3.4)
- State Management: React Query v5.63 for server state
- Form Handling: React Hook Form v7.54 + Zod v3.24
- Development Tools: Vite, Laravel Boost
- Code Quality: ESLint, Prettier, Laravel Pint
- LLM API integration for conversational price queries
- Geolocation services for location-based filtering
- Real-time price data synchronization
- PHP 8.3 or higher
- Node.js 18+ and npm/bun
- MySQL database
- Composer
- Clone the repository
git clone [repository-url]
cd askme- Install dependencies
# PHP dependencies
composer install
# JavaScript dependencies
npm install- Environment configuration
# Copy environment file
cp .env.example .env
# Generate application key
php artisan key:generate
# Configure database connection in .env
# Set up any required API keys- Database setup
# Run migrations
php artisan migrate
# (Optional) Seed with sample data
php artisan db:seed- Start development servers
# Start both frontend and backend servers
composer run dev
# Alternative: Start servers separately
# npm run dev (frontend)
# php artisan serve (backend)- Access the application
Open your browser and visit
http://localhost:8000
This project follows comprehensive development standards documented in CLAUDE.md. Key practices include:
- Laravel Boost Integration: All development tasks must use Laravel Boost tools for debugging and enhancement
- Spec-Driven Development: New features follow the specification workflow in
.claude/specs/ - Code Quality Standards: Laravel Pint (PHP), ESLint & Prettier (TypeScript/React)
- Testing Approach: PHPUnit for backend, feature tests preferred over unit tests
The codebase follows Laravel 12's streamlined structure with React/TypeScript frontend:
app/Http/Controllers/ # Feature controllers
app/Models/ # Eloquent models
resources/js/pages/ # Inertia page components
resources/js/components/ # Reusable React components
routes/ # Laravel route definitions
See .claude/steering/structure.md for complete organization guidelines.
# Code formatting
vendor/bin/pint # Format PHP code
npm run lint # Lint TypeScript/React
npm run format # Format with Prettier
# Testing
php artisan test # Run PHP tests
npm run test # Run JavaScript tests (if configured)
# Development server
composer run dev # Full-stack development server- Authentication and user management system
- Theme-aware responsive UI foundation
- Multi-session chat interface
- Basic LLM integration for price queries
- Location-based price filtering
- Enhanced price comparison algorithms
- Real-time pricing updates
- Mobile optimization
- Advanced analytics dashboard
- Chat conversation persistence
- API for third-party integrations
- Premium features for power users
- Merchant partnerships
- Advanced recommendation engine
- Multi-language support
This project uses a spec-driven development workflow. To contribute:
- Check existing specifications in
.claude/specs/ - Follow development guidelines in
CLAUDE.md - Use Laravel Boost for all development and debugging tasks
- Ensure all code follows the established conventions in
.claude/steering/
For detailed contribution guidelines, see the project's steering documents.
This project is licensed under the MIT License. See the LICENSE file for details.
For detailed development guidelines, see CLAUDE.md
For project specifications, see .claude/specs/
For architectural decisions, see .claude/steering/