{"id":50711980,"url":"https://github.com/developerdavid2/quotient","last_synced_at":"2026-06-09T16:03:31.981Z","repository":{"id":356348072,"uuid":"1232039945","full_name":"developerdavid2/quotient","owner":"developerdavid2","description":"AI-powered modern stock market app built with Next.js, Shadcn, Better Auth, and Inngest! Track real-time prices, set personalized alerts, explore company insights, and manage watchlists.","archived":false,"fork":false,"pushed_at":"2026-05-07T16:19:24.000Z","size":2552,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T18:30:29.554Z","etag":null,"topics":["agent","groq","inngest","market","mongodb","nextjs","stocks","tradeview"],"latest_commit_sha":null,"homepage":"https://quotient-stocks.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/developerdavid2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T14:28:08.000Z","updated_at":"2026-05-07T16:33:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/developerdavid2/quotient","commit_stats":null,"previous_names":["developerdavid2/quotient"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/developerdavid2/quotient","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerdavid2%2Fquotient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerdavid2%2Fquotient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerdavid2%2Fquotient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerdavid2%2Fquotient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developerdavid2","download_url":"https://codeload.github.com/developerdavid2/quotient/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerdavid2%2Fquotient/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34114444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","groq","inngest","market","mongodb","nextjs","stocks","tradeview"],"created_at":"2026-06-09T16:03:31.183Z","updated_at":"2026-06-09T16:03:31.976Z","avatar_url":"https://github.com/developerdavid2.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003cbr /\u003e\n    \u003cimg src=\"public/readme/hero.webp\" alt=\"Quotient - Stock Market App\"\u003e\n  \u003cbr /\u003e --\u003e\n\n  \u003cdiv\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Next.js-black?style=for-the-badge\u0026logoColor=white\u0026logo=next.js\u0026color=black\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Better Auth-black?style=for-the-badge\u0026logoColor=white\u0026logo=betterauth\u0026color=black\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Shadcn-black?style=for-the-badge\u0026logoColor=white\u0026logo=shadcnui\u0026color=black\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Inngest-black?style=for-the-badge\u0026logoColor=white\u0026logo=inngest\u0026color=black\"/\u003e\u003cbr/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-MongoDB-black?style=for-the-badge\u0026logoColor=white\u0026logo=mongodb\u0026color=00A35C\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-TailwindCSS-black?style=for-the-badge\u0026logoColor=white\u0026logo=tailwindcss\u0026color=38B2AC\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-TypeScript-black?style=for-the-badge\u0026logoColor=white\u0026logo=typescript\u0026color=3178C6\"/\u003e\n  \u003c/div\u003e\n\n  \u003ch3 align=\"center\"\u003eQuotient — AI-Powered Stock Market Tracker\u003c/h3\u003e\n  \u003cp align=\"center\"\u003eReal-time stock tracking, personalized alerts, and AI-driven market insights.\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n1. ✨ [Introduction](#introduction)\n2. ⚙️ [Tech Stack](#tech-stack)\n3. 🔋 [Features](#features)\n4. 🛠️ [Challenges \u0026 Fixes](#challenges)\n5. 🤸 [Quick Start](#quick-start)\n\n---\n\n## \u003ca name=\"introduction\"\u003e✨ Introduction\u003c/a\u003e\n\n**Quotient** is a full-stack, AI-powered stock market tracking application I built as part of my development portfolio. It combines real-time financial data, event-driven background workflows, and AI-generated market summaries into a polished, production-ready product.\n\nThe app allows users to track live stock prices, manage a personal watchlist, set price alert thresholds, and receive automated daily market digests via email — all powered by a modern Next.js architecture with MongoDB, Better Auth, Inngest, and Groq AI.\n\n---\n\n## \u003ca name=\"tech-stack\"\u003e⚙️ Tech Stack\u003c/a\u003e\n\n- **[Next.js](https://nextjs.org/docs)** — Full-stack React framework handling both the frontend UI and backend API routes with server-side rendering and server actions.\n\n- **[Better Auth](https://www.better-auth.com/)** — Framework-agnostic TypeScript authentication library powering email/password login, session management, and user accounts.\n\n- **[Finnhub](https://finnhub.io/)** — Real-time financial data API providing live stock quotes, company profiles, financial metrics, and market news.\n\n- **[Inngest](https://www.inngest.com/)** — Event-driven workflow platform used to orchestrate background jobs including alert checks, daily email digests, and AI inference steps.\n\n- **[Groq AI](https://groq.com/)** — Used via `step.ai.wrap()` with the Vercel AI SDK to generate personalized welcome emails and daily news summaries at no cost.\n\n- **[MongoDB](https://www.mongodb.com/)** — NoSQL database storing users, watchlists, and alert configurations.\n\n- **[Nodemailer](https://nodemailer.com/)** — Handles transactional email delivery for welcome emails, daily digests, and price alert notifications.\n\n- **[Shadcn/ui](https://ui.shadcn.com/)** + **[TailwindCSS](https://tailwindcss.com/)** — Component library and utility CSS framework used to build a clean, dark-mode-first responsive UI.\n\n- **[TradingView Widgets](https://www.tradingview.com/widget/)** — Embedded interactive charts including candlestick charts, market heatmaps, and financial overviews. Integrated via a custom `useTradingViewWidget` hook with memoized rendering.\n\n- **[TypeScript](https://www.typescriptlang.org/)** — Strict typing across the entire codebase for reliability and maintainability.\n\n---\n\n## \u003ca name=\"features\"\u003e🔋 Features\u003c/a\u003e\n\n👉 **Stock Dashboard** — Real-time market overview with interactive candlestick and baseline charts, a zoomable S\u0026P 500 heatmap grouped by sector, and a live market news feed.\n\n👉 **Intelligent Search** — Fast stock search powered by the Finnhub API with watchlist status indicators directly in results.\n\n👉 **Watchlist Management** — Add and remove stocks from a personal watchlist with live price, change percentage, market cap, and P/E ratio data displayed in a sortable table.\n\n👉 **Price Alerts** — Set upper and lower price threshold alerts per stock. Alerts are evaluated on a schedule via Inngest background jobs and trigger instant email notifications.\n\n👉 **AI-Powered Daily Digest** — Every day at noon, Inngest automatically fetches each user's watchlist news, summarizes it using Groq AI (Llama 3), and delivers a personalized email digest.\n\n👉 **Personalized Welcome Email** — On sign-up, an AI-generated welcome message is crafted based on the user's investment goals, risk tolerance, and preferred industry.\n\n👉 **Company Insights** — Deep-dive pages per stock with TradingView-powered financials, technical analysis, company profile, and recent news.\n\n👉 **Authentication** — Secure email/password sign-up and sign-in with session management via Better Auth.\n\n👉 **Performance Optimized** — TradingView widgets are wrapped in `React.memo` to prevent unnecessary re-renders given their heavy script injection cost.\n\n---\n\n\n## \u003ca name=\"quick-start\"\u003e🤸 Quick Start\u003c/a\u003e\n\n**Prerequisites**\n\n- [Git](https://git-scm.com/)\n- [Node.js](https://nodejs.org/en)\n- [npm](https://www.npmjs.com/)\n\n**Clone the repository**\n\n```bash\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperdavid2%2Fquotient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveloperdavid2%2Fquotient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperdavid2%2Fquotient/lists"}