A full-stack mobile hardware comparison platform designed to help users make data-driven purchasing decisions. RightToCompare bridges the gap between raw hardware specifications and user sentiment through interactive comparison grids, real-time market dashboards, and an AI-powered recommendation engine.
- Frontend Engine: React (v18), TypeScript, TailwindCSS, Shadcn UI, Radix UI primitives.
- Backend Architecture: Node.js, Express.js (TypeScript), Router-Controller-Service pattern.
- Database & Scripts: MongoDB (Mongoose ODM), Web Scraping
- Authentication: Firebase Client SDK + Server-Side Middleware Token Verification.
The frontend codebase strictly enforces a production-grade Page-Component-Primitive structural separation to ensure separation of concerns and maintainable scaling:
/pages: House full-screen layout views tied directly to client-side routing routes (e.g.,TrendsPage,PhoneCatalogPage). This prevents routing layouts from cluttering reusable presentation logic./components: Divided into isolated, feature-specific subdirectories (/trends,/catalog,/comparison,/auth). Components sitting here manage distinct feature states independently./components/ui: Reserved exclusively for clean, stateless, reusable user interface primitives (Shadcn/Radix foundations).
To experience the platform's advanced capabilities without running the entire stack locally, review the interactive technical demonstrations below:
1. Side-by-Side Comparison Grid & Row Filtering (Demo)
A high-performance alignment layout that uses client-side state manipulation to render multi-dimensional device parameters side-by-side. Includes responsive row-hiding controls to dynamically filter out unneeded specifications, optimizing viewport scannability for extensive hardware datasets.
2. Conversational AI Device Recommendation Engine (Demo)
An intelligent, natural language processing pipeline that bridges user-space prompts with backend machine learning evaluation loops. Users can input fluid contextual requirements (e.g., "Find a phone under $700 with a top-tier camera and all-day battery life"), and the engine parses the technical criteria to dynamically return a ranked, granularly matched inventory grid.
3. Market Intelligence & Sentiment Trend Dashboard (Demo)
An advanced analytics suite utilizing interactive data visualization layouts to monitor macro-level market shifts and brand reputation based on aggregated user review metrics.
- Market Trend Visualization: Tracks upward and downward momentum across the broader mobile sector by charting historical sentiment trajectories.
- Granular & Macro Graphing: Dynamically renders isolated sentiment graphs for individual device models alongside aggregated, top-level brand reputation scores.
- Live Trending Ticker: A real-time rolling data ticker that identifies and broadcasts the most polarized hardware topics (highest positive/negative density) over a trailing 30-day window.
4. Keyword-Based Sentiment Analyzer & Review Aggregator (Demo)
A deterministic text-parsing infrastructure designed to audit community reviews and forum posts in real time.
- Algorithmic Keyword Matching: Scans incoming text payloads against an optimized dictionary of descriptive sentiment benchmarks to classify mentions as explicitly positive or negative.
- Dynamic Post Tagging: Generates and appends visual sentiment indicators directly onto individual community posts upon database ingestion.
- Data Aggregation Layer: Mathematically compiles individual keyword markers into a centralized, live "Pros & Cons" summary grid across all community content on the device page.
5. Real-Time Community Discussion & Forum (Demo)
A dynamic, threaded community discussion interface engineered for seamless user interaction and instantaneous UI state synchronization.
- Threaded State Management: Manages complex, nested data structures on the client side, allowing users to engage in multi-tiered conversations without performance degradation.
- Optimistic UI Rendering: Ensures instantaneous client-side updates upon payload submission, providing a fluid, app-like responsiveness before awaiting backend database confirmation.
- Contextual Data Association: Ties user-generated content schemas directly to specific device IDs, building hyper-relevant, localized knowledge bases for every hardware entry in the catalog.
6. Administrative Control Console (Demo)
A secure administrative console restricted behind server-side authorization check gates to orchestrate platform data lifecycles:
- Pipeline Triggers: Manual override interface to instantly initialize background web-scraping scripts, pulling and normalizing fresh device data streams into the live database.
- System Auditing: Secure, centralized tracking of conversational AI transaction histories and user chatlogs for runtime performance evaluation and debugging.
- Data Mutation Isolation: Restricts critical CRUD operations (Create, Read, Update, Delete) exclusively to authenticated administrator accounts, blocking unauthorized access to master MongoDB schemas.
- Frontend Engine & UI: React (v18), TypeScript, TailwindCSS, Figma.
- Backend Architecture: Node.js, Express.js, TypeScript, Router-Controller-Service Pattern.
- Data Management & Gathering: MongoDB (Mongoose ODM), Scraping Infrastructure, External API Integrations (GeekBench).
- Security Implementation: Input Sanitization, Server-Side Authorization Gates, HTTP Rate Limiting, Environment Variable Isolation.
- Node.js (v18.x or higher)
- Active MongoDB Instance (Local Daemon or Atlas Configuration)
git clone [https://github.com/drnpf/righttocompare.git](https://github.com/drnpf/righttocompare.git)
cd righttocompareEstablish a comprehensive .env cluster inside your root backend directory structure. Do not commit your active API keys to version control:
# Server Configuration
PORT=5001
# MongoDB Pipeline Connections
MONGO_URI=your_cluster_connection_string
DB_NAME=test
PHONE_COLLECTION=phones
SCRAPE_COLLECTION=scrape_output
# AI Recommendation Engine (ChatBot)
MAX_CANDIDATES=200
# Security & Authorization Gates
FIREBASE_WEB_API_KEY=your_firebase_client_key
INTERNAL_BYPASS_KEY=your_administrative_override_secretBecause this application utilizes a fully decoupled architecture, the client and server environments must be initialized in separate terminal instances.
Terminal 1: Backend Initialization
# Navigate to the server directory
cd backend
# Ingest backend dependencies
npm install
# Initialize the Express server (Listens on Port 5001)
npm run dev
# If you are on LINUX use:
npm run dev:linuxTerminal 2: Frontend Initialization
# Navigate to the client directory
cd frontend
# Ingest frontend UI dependencies
npm install
# Initialize the React runtime environment (Starts on Port 3000)
npm run devRightToCompare was designed and developed as a collaborative Computer Science Senior Capstone Project (Class of 2026) by:
A special thanks to our advisors and peers at California State University, Long Beach for their guidance and feedback throughout the software development lifecycle.





