Qor AI
Overview
Qor AI is the current production-focused mobile app for personalized tech discovery, product comparison, subscription analysis, and AI-assisted buying decisions. The app is built primarily for Android and iOS with Flutter, uses Riverpod for state orchestration, GoRouter for app navigation, PocketBase for app data/auth/admin flows, Typesense for fast product search, DeepSeek for cost-efficient text intelligence, and Gemini for multimodal vision plus grounded web analysis.
The current mobile shell is built around five persistent product surfaces:
- PC Build
- Compare
- Home
- Link AI
- Subscriptions
Outside that shell, the app also includes product detail, AI chat, search, profile/settings, visual scanner, notifications, recent history, collections, behavior report, and premium/paywall flows.
Current Product Experience
1. Personalized Home Feed
- Personalized landing feed with category rails, recommendation blocks, trending picks, and premium highlights.
- Match-oriented discovery driven by quiz/profile signals, browsing behavior, favorites, and category priorities.
- Fast-loading product cards with Q badges, tech scores, quick compare entry points, and AI shortcuts.
2. Product Detail Intelligence
- Large hero product presentation with gallery, compare shortcut, sharing, favorites, and AI actions.
- Tech Score, compatibility/match score, specs, similar products, reviews, and premium analysis tabs.
- Community review synthesis, pros/cons, pricing surfaces, and embedded YouTube review handling.
- AI-gated premium surfaces now share a single localized Q-limit experience.
3. Compare Flow
- Compare queue with product search, score chips, and add/remove actions.
- Side-by-side comparison results for specs, strengths, and fit-oriented recommendations.
- Link-based comparison support for external URLs and AI-assisted decision output.
4. Link AI
- Paste a product URL and let AI validate the page, identify the product, and enrich the result.
- Single-link analysis and multi-link comparison support.
- Quiz-assisted compatibility scoring layered on top of scraped metadata and model reasoning.
5. Subscription Intelligence
- Enter services like Netflix, Spotify, ChatGPT Plus, Disney+, Apple One, and similar subscriptions.
- AI resolves the entered services, builds a short personal quiz, and blends web/community signals into a final recommendation.
- Localized progress timeline, info cards, premium/Qor gating, and subscription history flows.
- Daily Q limit warnings now use the same premium purple language-safe experience instead of the previous red inline warning.
6. PC Builder AI
- Dedicated PC Builder landing, active build flow, and build history screens.
- Component-by-component system assembly with compatibility awareness and AI analysis.
- AI-generated upgrade suggestions and system diagnosis.
- PC Builder Q-limit messaging now also uses the shared localized premium limit copy.
7. Visual Scanner
- Camera-based product recognition powered by Gemini multimodal analysis.
- Image capture, product understanding, and follow-up Q&A flow.
- Reuses the same premium/Q-limit dialog system as other AI-gated features.
8. AI Chat and Decision Assistance
- Context-aware AI chat entry points from the app shell and feature flows.
- Product-aware and page-aware prompts for follow-up decision support.
- Daily Q system for free usage with premium unlock path.
Platform Features
- Authentication with email/password, Google Sign-In, and Apple Sign-In.
- Premium gating and daily Q economy for AI-heavy actions.
- Local persistence via Hive and SharedPreferences.
- Firebase Cloud Messaging + local notifications.
- Multi-language UI via Flutter l10n.
- Dark/light theming and brand-driven OLED-friendly presentation.
Admin, Content, and Operations
The repository also contains the operational surfaces required to run the product end to end:
admin/: static admin panel for product, user, comparison, scraper, algorithm, and app-control operations.pb_hooks/: server hooks for AI proxying and sync tasks.migration/: one-off migration, repair, schema, and deployment scripts.scripts/: automation for scraping, security audits, deploys, dictionary/build helpers, and maintenance tasks.website/: public site deployment target.
Key admin capabilities include:
- product CRUD and bulk operations
- user management and premium controls
- scraper and ingestion workflows
- app-wide config / maintenance / notification tooling
- algorithm and scoring configuration
- deployment and Coolify hardening scripts
Tech Stack
| Layer | Stack |
|---|
| Mobile App | Flutter 3.10.4 / Dart |
| State Management | Riverpod |
| Routing | GoRouter |
| Backend | PocketBase |
| Search | Typesense |
| Text AI | DeepSeek |
| Vision + Grounded AI | Gemini via PocketBase proxy |
| Caching | Hive, SharedPreferences |
| Media | CachedNetworkImage, YouTube iframe/player flows, Camera |
| Payments | in_app_purchase |
| Push | Firebase Messaging, flutter_local_notifications |
| Admin Panel | Vanilla JS + static hosting |
| Infra / Deploy | Coolify, Hetzner, Node.js scripts |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
