A modern vehicle valuation platform that uses Claude AI to provide real-time market analysis for cars. Built with React, Material-UI, and Node.js to deliver professional-grade vehicle intelligence.
Drive Value AI is a working MVP with core functionality implemented across three services:
- 🚗 Frontend App - React + Material-UI interface with authentication
- 🤖 AI Backend - Claude AI integration for vehicle valuations
- 👤 User API - Google OAuth authentication and user management
- ✅ Authentication System - Google OAuth login/register
- ✅ Home Page - Professional landing page with stats
- ✅ Search Page - VIN input with validation and search functionality
- ✅ Vehicle Drawer - Detailed vehicle information display
- ✅ History Page - Search history and favorites
- ✅ Profile Page - User profile management
- ✅ Responsive Design - Mobile-optimized Material-UI interface
- ✅ State Management - Redux Toolkit for app state
- ✅ VIN Decoding - Auto.dev API integration for vehicle specs
- ✅ Claude AI Analysis - Advanced market valuation prompts
- ✅ Condition-Based Pricing - Dynamic adjustments based on condition
- ✅ Performance Vehicle Analysis - Specialized high-performance car analysis
- ✅ Test Mode - Mock responses for development
- ✅ API Endpoints -
/api/valuation,/api/test-valuation
- ✅ Google OAuth - Seamless Google sign-in integration
- ✅ JWT Authentication - Secure token-based auth
- ✅ User Management - Profile, preferences, statistics
- ✅ MongoDB Integration - User data persistence
- ✅ Admin Features - User administration and role management
- Framework: React 18 with Vite
- UI Library: Material-UI v5 with custom dark theme
- State Management: Redux Toolkit
- Routing: React Router v6
- Authentication: Google OAuth integration
- Styling: Custom theme with Space Grotesk fonts
- Framework: Express.js server
- AI Integration: Claude AI API with advanced prompts
- VIN Decoding: Auto.dev API integration
- Validation: VIN format and condition validation
- Testing: Mock responses for development
- Database: MongoDB with Mongoose ODM
- Authentication: Google OAuth + JWT tokens
- Security: Helmet, CORS, input validation
- Features: User profiles, preferences, statistics
- ✅ VIN Input & Validation - 17-character VIN format checking
- ✅ Vehicle Decoding - Automatic specification extraction
- ✅ AI Market Analysis - Claude AI-powered valuation
- ✅ Condition Adjustments - Excellent, good, fair, poor pricing
- ✅ Performance Vehicles - Specialized analysis for sports cars
- ✅ Multiple Value Types - Retail, private party, trade-in values
- ✅ Google Authentication - One-click sign-in
- ✅ Search History - Track previous valuations
- ✅ Favorites System - Save interesting vehicles
- ✅ Responsive Design - Works on all devices
- ✅ Professional UI - Clean, modern interface
- ✅ Real-time Validation - Instant VIN format checking
- 🔧 API Integration - Connect React app to AI backend
- 🔧 Authentication Flow - Connect Google OAuth to user API
- 🔧 Error Handling - Robust error states and loading indicators
- 🔧 Environment Setup - Proper API endpoint configuration
- 📄 PDF Report Generation - Downloadable valuation reports
- 💳 Payment Integration - Stripe for premium reports
- 📧 Email Reports - Send reports via email
- 🔍 Enhanced Search - Better vehicle information display
- 📱 Mobile Optimization - Touch-friendly interface improvements
- ⚡ Performance - Faster loading and better caching
- 🎨 UI Refinements - Polish animations and interactions
- 🔒 Security - Input sanitization and API security
- 📊 Analytics Dashboard - User statistics and usage metrics
- 💰 Subscription Plans - Free vs premium tiers
- 📈 Market Trends - Historical pricing data
- 🏪 Dealer Tools - Bulk VIN processing for dealers
- 🗄️ Database Integration - Persistent storage for valuations
- 🔄 Caching Layer - Redis for performance
- 📊 Monitoring - Error tracking and performance metrics
- 🚀 Deployment - Production deployment setup
- 🔌 API Access - Public API for third-party integration
- 📱 Mobile App - React Native mobile application
- 🤖 Advanced AI - More sophisticated valuation algorithms
- 🌍 Market Expansion - International markets and currencies
- Node.js (v18 or higher)
- MongoDB (local or Atlas)
- Claude AI API key
- Google OAuth credentials
-
Clone and Install:
git clone <your-repo> cd Drive-Value-AI # Install frontend dependencies cd drive-value-ai-frontend npm install # Install backend dependencies cd ../autovalidation-backend npm install # Install user API dependencies cd ../drive-value-user-api npm install
-
Environment Configuration:
# AI Backend (.env) CLAUDE_API_KEY=your_claude_api_key AUTO_DEV_API_KEY=your_auto_dev_api_key PORT=3001 # User API (.env) MONGODB_URI=mongodb://localhost:27017/drivevalue GOOGLE_CLIENT_ID=your_google_client_id GOOGLE_CLIENT_SECRET=your_google_client_secret JWT_SECRET=your_jwt_secret # Frontend (.env) VITE_API_URL=http://localhost:3001 VITE_USER_API_URL=http://localhost:3002
-
Start All Services:
# Terminal 1 - AI Backend cd autovalidation-backend npm run dev # Terminal 2 - User API cd drive-value-user-api npm run dev # Terminal 3 - Frontend cd drive-value-ai-frontend npm run dev
-
Access the Application:
- Frontend:
http://localhost:5173 - AI Backend:
http://localhost:3001 - User API:
http://localhost:3002
- Frontend:
npm run dev- Development servernpm run build- Production buildnpm run preview- Preview build
npm run dev- Development with auto-restartnpm start- Production modenpm test- Run tests
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Frontend │ │ AI Backend │ │ User API │
│ (React) │ │ (Node.js) │ │ (Node.js) │
│ Port: 5173 │ │ Port: 3001 │ │ Port: 3002 │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ • Authentication│◄──►│ • VIN Decoding │ │ • Google OAuth │
│ • Search UI │ │ • Claude AI │ │ • User Profiles │
│ • Results │ │ • Valuation │ │ • JWT Tokens │
│ • History │ │ • Mock Testing │ │ • MongoDB │
└─────────────────┘ └─────────────────┘ └─────────────────┘
The platform has a solid foundation with:
- ✅ Working authentication system
- ✅ AI-powered valuation engine
- ✅ Professional user interface
- ✅ Modular, scalable architecture
Perfect for building the next generation of vehicle valuation intelligence! 🚀