🚀 Signalist – AI-Powered Stock Market App

Modern real-time financial platform with alerts, charts, watchlists, and AI insights

---

📋 Table of Contents

1. ✨ Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start
5. 📊 Usage
6. 🌍 Roadmap
7. 🤝 Contributing
8. 📜 License

---

✨ Introduction

Signalist is an AI-powered stock market app built with Next.js, Shadcn, Better Auth, and Inngest.
It provides real-time financial data, personalized alerts, watchlists, and AI-driven insights.
Admins can manage stocks, publish news, and monitor user activity, while event-driven workflows power automated alerts, daily digests, and sentiment analysis.

Whether you’re a developer, trader, or data enthusiast, Signalist delivers a dynamic, real-time financial platform.

---

⚙️ Tech Stack

• Next.js – Full-stack React framework with SSR/SSG support.
• TypeScript – Statically typed superset of JavaScript.
• TailwindCSS – Utility-first CSS framework.
• Shadcn – Accessible React components for beautiful UI.
• Better Auth – Authentication & authorization with MFA + social login.
• Inngest – Event-driven workflows and background jobs.
• MongoDB – NoSQL database for scalable data storage.
• Nodemailer – Email delivery & notifications.
• Finnhub – Real-time market data API.
• CodeRabbit – AI-powered GitHub code review assistant.

---

🔋 Features

👉 Stock Dashboard – Real-time prices with line/candlestick charts & historical data.
👉 Powerful Search – Intelligent stock search by industry, market cap, or performance.
👉 Watchlist & Alerts – Personalized watchlists with instant email alerts.
👉 Company Insights – PE ratio, EPS, revenue, analyst ratings, sentiment scores & filings.
👉 Real-Time Workflows – Automated price updates, scheduling & AI digests powered by Inngest.
👉 AI Insights – Personalized summaries, earnings notifications & daily reports.
👉 Custom Notifications – Fine-tuned alerts based on user preferences.
👉 Analytics & Admin Dashboard – Manage users, publish news, monitor activity.

---

🤸 Quick Start

Prerequisites

Ensure you have installed:

• Node.js (v18+ recommended)
• Git
• MongoDB instance

Installation

Cloning the Repository

git clone https://github.com/saadat-khan/Signalist_stock-tracker-app.git
cd Signalist_stock-tracker-app

Installation

Install the project dependencies using npm:

npm install

Set Up Environment Variables

Create 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_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.

Running the Project

npm run dev
npx inngest-cli@latest dev

Open http://localhost:3000 in your browser to view the project.

---

📊 Usage

• Sign up with Better Auth (email, Google, GitHub, etc.).

• Add stocks to your watchlist.

• Set alerts for price or volume changes.

• Explore company insights & AI summaries.

• Use the admin dashboard to manage stocks, publish news, and track users.

---

🌍 Roadmap

📱 Mobile app version (React Native)

🔔 Push notifications (Web + Mobile)

📈 Portfolio tracking with performance metrics

🤖 Advanced AI insights (trend predictions & risk analysis)

🌐 Multi-language support

---

🤝 Contributing

We welcome contributions! 🎉 Please fork the repo and submit a pull request. Before contributing, check out the guidelines in CONTRIBUTING.md.

---

📜 License

This project is licensed under the MIT License. See LICENSE for more details.