AI-powered modern stock market platform built with Next.js, Shadcn, Better Auth, and Inngest. Track real-time prices, explore company insights, manage watchlists, and receive personalized alerts.
Perfect for traders, investors, and developers seeking a dynamic financial dashboard.
Perfect for traders, investors, and developers seeking a dynamic financial dashboard.
- ✨ Introduction
- ⚙️ Tech Stack
- 🔋 Features
- 🤸 Quick Start
- 🧱 Project Structure
- 📝 Customization
- 🤝 Contribution
- 🔗 Contacts
- 📄 License
- 🙏 Acknowledgements
Signalist Stock Tracker App is a real-time stock market platform with AI-powered alerts, personalized dashboards, and comprehensive company insights. Users can:
- Track real-time stock prices with interactive line and candlestick charts
- Set custom watchlists and alerts for price movements or volume spikes
- Explore detailed company profiles, financials, and technical analysis
- Receive automated daily summaries and notifications powered by Inngest workflows
- Access a responsive admin dashboard for managing news, stocks, and user activity
Ideal for investors, traders, and developers looking for an interactive financial platform with event-driven automation and AI insights.
- Next.js is a powerful React framework for building full-stack web applications. It provides server-side rendering, static site generation, and API routes, allowing developers to create optimized and scalable apps quickly.
- Shadcn is an open-source library of fully customizable, accessible React components. It helps teams rapidly build consistent, visually appealing UIs while allowing full control over design and layout.
- Better Auth is a framework-agnostic authentication and authorization library for TypeScript. It provides built-in support for email/password login, social sign-on (Google, GitHub, Apple, and more), and multi-factor authentication, simplifying user authentication and account management.
- Inngest is a platform for event-driven workflows and background jobs. It allows developers to build reliable, scalable automated processes such as real-time alerts, notifications, and AI-powered workflows.
- MongoDB is a flexible, high-performance NoSQL database. It stores data in JSON-like documents, supports dynamic schemas, and provides robust features for scalability, replication, and querying.
- CodeRabbit is an AI-powered code review assistant that integrates with GitHub. It helps developers catch bugs, enforce best practices, and maintain consistent code quality across pull requests, reducing manual review effort and speeding up the development workflow.
- TailwindCSS is a utility-first CSS framework that allows developers to build custom, responsive designs quickly without leaving their HTML. It provides pre-defined classes for layout, typography, colors, and more.
- TypeScript is a statically typed superset of JavaScript that improves code quality, tooling, and error detection. It is ideal for building large-scale applications and enhances maintainability.
- Nodemailer is a Node.js library for sending emails easily. It supports various transport methods such as SMTP, OAuth2, and third-party services, making it a reliable tool for handling transactional emails, notifications, and contact forms in applications.
- Finnhub is a real-time financial data API that provides stock, forex, and cryptocurrency market data. It offers developers access to fundamental data, economic indicators, and news, making it useful for building trading apps, dashboards, and financial analysis tools.
- Vercel – Deployment and hosting platform
- 📊 Stock Dashboard – Track real-time stock prices with interactive line and candlestick charts, including historical data, and filter stocks by industry, performance, or market cap.
- 🔍 Intelligent Search – Quickly find the best stocks with an intelligent search system that helps you navigate through Signalist.
- ⭐ Watchlist & Alerts – Create a personalized watchlist, set alert thresholds for price changes or volume spikes, and receive instant email notifications to stay on top of the market.
- 🏢 Company Insights – Explore detailed financial data such as PE ratio, EPS, revenue, recent news, filings, analyst ratings, and sentiment scores for informed decision-making.
- ⚡ Real-Time Workflows: Powered by Inngest, automate event-driven processes like price updates, alert scheduling, automated reporting, and AI-driven insights.
- 🤖 AI-Powered Alerts & Summaries – Generate personalized market summaries, daily digests, and earnings report notifications, helping users track performance and make data-driven decisions.
- 📱 Responsive & Accessible UI – Optimized for desktop and mobile
- 🔔 Customizable Notifications – Fine-tune alerts and notifications based on user watchlists and preferences for a highly personalized experience.
- 📈 Analytics & Insights – Gain insights into user behavior, stock trends, and engagement metrics, enabling smarter business and trading decisions.
And many more, including code architecture and reusability.
Make sure you have the following installed on your machine:
git clone https://github.com/Itssanthoshhere/Signalist-Stock-Tracker-App.git
cd Signalist-Stock-Tracker-AppInstall the project dependencies using npm:
npm installCreate a new file named .env in the root of your project and add the following content:
NODE_ENV='development'
NEXT_PUBLIC_BASE_URL=http://localhost:3000
# FINNHUB
NEXT_PUBLIC_FINNHUB_API_KEY=
FINNHUB_BASE_URL=https://finnhub.io/api/v1
# MONGODB
MONGODB_URI=
# BETTER AUTH
BETTER_AUTH_SECRET=
BETTER_AUTH_URL=http://localhost:3000
# GEMINI
GEMINI_API_KEY=
# NODEMAILER
NODEMAILER_EMAIL=
NODEMAILER_PASSWORD=Replace the placeholder values with your real credentials. You can get these by signing up at: MongoDB, Gemini, Inngest, Finnhub.
npm run dev
npx inngest-cli@latest devOpen http://localhost:3000 in your browser to view the project.
| File/Folder | Description |
|---|---|
app/ |
Next.js pages, API routes, and layouts |
components/ |
React UI components (charts, widgets, search, watchlist) |
hooks/ |
Custom React hooks (useTradingViewWidget, useDebounce) |
lib/ |
Constants, utils, actions, Inngest workflows, and Nodemailer |
database/ |
MongoDB models and connection |
public/ |
Assets and images |
scripts/ |
Utility scripts (DB testing) |
types/ |
TypeScript type definitions |
next.config.ts |
Next.js configuration |
package.json |
Project dependencies |
- Update charts and widgets via
lib/constants.ts - Add/remove watchlist features using
components/WatchlistButton.tsx - Customize alerts and workflows with Inngest in
lib/inngest - Extend search functionality with
components/SearchCommand.tsx
Contributions are welcome!
- Fork the repository
- Create a branch (
git checkout -b feature/my-feature) - Make your changes
- Commit (
git commit -m 'feat: my feature') - Push (
git push origin feature/my-feature) - Open a Pull Request
- GitHub: Itssanthoshhere
- LinkedIn: Santhosh VS
This project is for educational and portfolio purposes. All logos, assets, and branding belong to their respective owners.
- Next.js – React framework for full-stack apps
- TailwindCSS – Styling utilities
- Vercel – Deployment platform
- TradingView – Interactive stock widgets
- Inngest – Event-driven workflows
If you like this project, give it a ⭐ and share it with your network!