gear_ai_v1
Gear AI CoPilot 🚗🤖
Your intelligent automotive ownership assistant - powered by AI, telematics, and real-time market data.
Gear AI CoPilot is a comprehensive mobile application that consolidates fragmented automotive tools into a single, intelligent “Digital Twin” for your vehicle. From VIN decoding and owner’s manual RAG chat to OBD-II diagnostics and real-time valuation, Gear AI transforms how you manage, maintain, and understand your vehicle.
🎯 Development Stage: Phase 1 MVP (65% Complete)
Current Status: Mid-to-late Phase 1 development with production-ready infrastructure and UI, but partial backend implementation.
| 📊 View Development Status | Comprehensive Assessment |
Key Highlights:
- ✅ Infrastructure: 95% complete (deployment-ready)
- ✅ Frontend UI: 95% complete (all screens designed)
- ⚠️ Backend: 35% complete (schema ready, services partial)
- ⏱️ Time to MVP: 2-3 weeks (simplified) or 4-5 weeks (full)
📋 Table of Contents
- Development Stage
- Features
- Technology Stack
- Getting Started
- Project Structure
- Documentation
- Subscription Tiers
- Roadmap
- Contributing
- License
✨ Features
Note: UI components are complete for all features below, but backend integration is partial. See Development Assessment for details.
Current (Phase 1 - MVP)
- ✅ Liquid Glass UI: Premium glassmorphism design system (100% complete)
- ✅ VIN Decoding: NHTSA API integration for vehicle identification (100% complete)
- ⚠️ Vehicle Management: Add vehicles via VIN entry (UI complete, DB integration pending)
- ⚠️ Owner’s Manuals: Browse and access vehicle manuals (UI complete, content pending)
- ⚠️ AI Chat Assistant: Conversational AI for automotive questions (UI complete, AI integration pending)
- ⚠️ Maintenance Tracking: Log service history with cost tracking (UI complete, persistence pending)
- ⚠️ Multi-Vehicle Support: Manage multiple vehicles (UI ready, auth pending)
- ⚠️ Diagnostic Dashboard: View diagnostic trouble codes (UI complete, OBD-II pending)
Coming Soon (Phase 2-3)
- 🔜 RAG-Powered Manual Chat: Ask specific questions, get manual-backed answers
- 🔜 OBD-II Diagnostics: Real-time vehicle health via Bluetooth ELM327 adapter
- 🔜 Visual Damage Detection: AI-powered damage assessment from photos
- 🔜 Real-Time Valuation: Market value tracking with depreciation analysis
- 🔜 Loan & Lease Tracker: Financial optimization tools
Future (Phase 4+)
- 🚀 Marketplace Integration: Sell directly to AutoTrader, CarGurus
- 🚀 Predictive Maintenance: ML-based failure prediction
- 🚀 Fleet Management: Business dashboard for dealers and fleets
See ROADMAP.md for detailed phase planning.
🛠️ Technology Stack
Frontend
- Framework: React Native 0.79 with Expo SDK 53
- Language: TypeScript 5.8
- Navigation: Expo Router (file-based routing)
- UI Components: Custom “Liquid Glass” design system
- Styling: Expo Linear Gradient, Expo Blur
Backend
- BaaS: Supabase (PostgreSQL 15 + pgvector)
- Auth: Firebase Auth (synced with Supabase)
- Serverless: Supabase Edge Functions (Deno runtime)
- Storage: Supabase Storage (for photos, manuals)
AI/ML
- LLM: OpenAI GPT-4 for conversational AI
- Embeddings: intfloat/e5-base-v2 (768 dimensions)
- Vector Search: pgvector with ivfflat indexing
- Computer Vision: YOLOv8 (planned for damage detection)
Third-Party APIs
- VIN Decoding: NHTSA vPIC
- Diagnostics: CarMD
- Valuation: MarketCheck, Black Book
- Parts: SEMA Data (ACES/PIES)
- Payments: Stripe Connect
🚀 Getting Started
Important: Repository has been cleaned and optimized! See DEPLOYMENT_READY.md for deployment preparation.
Quick Start
- Clone and Install
git clone https://github.com/mmanthe37/gear_ai_v1.git cd gear_ai_v1 npm install - Configure Environment
cp .env.example .env.local # Edit .env.local with your Firebase and Supabase credentials - Start Development
npm start # Press 'w' for web, 'i' for iOS, 'a' for Android
Full Setup Guide
For complete installation, configuration, and deployment instructions, see:
- 📖 Quick Start Guide - Detailed setup instructions
- 🚀 Deployment Ready Guide - Prepare for production deployment
- 🏗️ Build & Deployment - Comprehensive deployment options
📊 Current Status
This repository has been cleaned and refactored:
- ✅ Removed 250+ lines of dead code
- ✅ Consolidated documentation (16 → 10 files)
- ✅ Eliminated redundant dependencies
- ✅ Ready for environment configuration
See docs/DEVELOPMENT_STATUS.md for feature completion status.
📁 Project Structure
gear_ai_v1/
├── app/ # Expo Router screens
│ ├── (tabs)/ # Tab navigation screens
│ ├── chat/ # Chat conversation screens
│ ├── _layout.tsx # Root layout
│ ├── index.tsx # Landing/home
│ └── login.tsx # Authentication
├── components/ # Reusable UI components (9 components)
├── contexts/ # React contexts (Auth)
├── lib/ # Third-party integrations
│ ├── firebase.ts # Firebase setup
│ └── supabase.ts # Supabase client
├── services/ # Business logic (9 services)
│ ├── ai-service.ts # OpenAI integration
│ ├── auth-service.ts # Authentication
│ ├── diagnostic-service.ts
│ ├── manual-*.ts # Owner's manual services
│ ├── rag-pipeline.ts # Vector search
│ └── vin-decoder.ts # NHTSA VIN API
├── types/ # TypeScript definitions (8 type files)
├── docs/ # Documentation (10 docs)
├── supabase/ # Database migrations
└── assets/ # Images, fonts, icons
📚 Documentation
Comprehensive documentation is organized in the /docs directory:
Essential Guides
- 🚀 Deployment Ready - Prepare for production deployment
- 📊 Development Status - Current completion status
- 🏗️ Architecture - System design and technology stack
- 📖 Quick Start - Getting started guide
Technical Documentation
- 🗄️ Database Schema - Supabase database design
- 🔌 API Integration - Third-party API specifications
- 🎨 Design System - “Liquid Glass” UI guidelines
- 🔒 Security - Security & compliance (GDPR, CCPA)
- 🛣️ Roadmap - Development phases and timeline
Deployment & Build
- 🏗️ Build & Deployment - Comprehensive deployment guide
- 🔐 Authentication - Firebase Auth setup
💰 Subscription Tiers
| Feature | Free | Pro ($9.99/mo) | Mechanic ($19.99/mo) | Dealer ($99.99/mo) |
|---|---|---|---|---|
| Vehicles | 1 | 3 | Unlimited | Unlimited |
| VIN Entry | ✅ | ✅ | ✅ | ✅ |
| OCR VIN Scan | ❌ | ✅ | ✅ | ✅ |
| Manual Access | ✅ | ✅ | ✅ | ✅ |
| Basic AI Chat | ✅ | ✅ | ✅ | ✅ |
| RAG Manual Chat | ❌ | ✅ | ✅ | ✅ |
| OBD-II Diagnostics | ❌ | ❌ | ✅ | ✅ |
| Damage Detection | ❌ | ❌ | ✅ | ✅ |
| Valuation Tracking | ❌ | ✅ | ✅ | ✅ |
| Marketplace Tools | ❌ | ❌ | ✅ | ✅ |
| Web Dashboard | ❌ | ❌ | ❌ | ✅ |
| API Access | ❌ | ❌ | ❌ | ✅ |
🗺️ Roadmap
- Q1 2025: MVP Launch (Phase 1) - Auth, Vehicle Management, Basic AI Chat
- Q2 2025: RAG & Diagnostics (Phase 2) - Manual RAG, OBD-II integration
- Q3 2025: Visual Intelligence (Phase 3) - Damage detection, Valuation API
- Q4 2025: Marketplace (Phase 4) - Peer-to-peer sales, Shop network
- Q1 2026: Fleet Management (Phase 5) - Business dashboard, API access
- 2026+: Predictive ML, Global expansion, AR features
See ROADMAP.md for detailed feature planning.
🤝 Contributing
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Code Standards
- Use TypeScript strict mode
- Follow the existing code style (Prettier + ESLint)
- Write descriptive commit messages (Conventional Commits)
- Add tests for new features (when applicable)
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- NHTSA - Free VIN decoding API
- Supabase - Backend infrastructure
- OpenAI - GPT-4 and embeddings
- Expo - React Native development platform
- Inspired by modern automotive digital dashboards and AI-first design
📞 Contact
- Project Maintainer: @mmanthe37
- Email: support@gearai.app (planned)
- Issues: GitHub Issues
Built with ❤️ for automotive enthusiasts and everyday drivers alike.