Skip to content

About

A full-stack MERN application featuring side-by-side phone comparison grids, interactive community discussion boards, real-time user sentiment trackers, and an AI-powered device recommendation chatbot.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

467 Commits

Folders and files

Repository files navigation

RightToCompare | Mobile Device Analytics & Comparison Platform

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.


Tech Stack & Architecture Design

  • 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.

Component & Page Hierarchy

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).

High-Value Feature Showcases

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)

RightToCompare Matrix Engine

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)

RightToCompare ML Core

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)

RightToCompare Analytics

An advanced analytics suite utilizing interactive data visualization layouts to monitor macro-level market shifts and brand reputation based on aggregated user review metrics.

Core Dashboard Capabilities:

  • 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)

RightToCompare Sentiment Engine

A deterministic text-parsing infrastructure designed to audit community reviews and forum posts in real time.

Key Engineering Mechanics:

  • 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)

RightToCompare Discussion Board

A dynamic, threaded community discussion interface engineered for seamless user interaction and instantaneous UI state synchronization.

Core Engineering Mechanics:

  • 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)

RightToCompare Admin Operations

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.

Complete Technical Competency Grid

  • 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.

Local Deployment Blueprint

Prerequisites

  • Node.js (v18.x or higher)
  • Active MongoDB Instance (Local Daemon or Atlas Configuration)

1. Repository Setup

git clone [https://github.com/drnpf/righttocompare.git](https://github.com/drnpf/righttocompare.git)
cd righttocompare

2. Environment Variables Configuration

Establish 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_secret

3. Dependency Aggregation & Service Execution

Because 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:linux

Terminal 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 dev

The Engineering Team

RightToCompare 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.

About

A full-stack MERN application featuring side-by-side phone comparison grids, interactive community discussion boards, real-time user sentiment trackers, and an AI-powered device recommendation chatbot.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages