Real-time stock market intelligence with AI-powered insights
Track live stock prices • Build personalized watchlists • Get AI-curated daily market news
Live Demo · Report Bug · Request Feature
Signalist is a modern stock market tracking platform built for investors who want real-time data, actionable insights, and personalized market intelligence—all in one place.
Powered by Finnhub API for live market data and TradingView for professional-grade charting, Signalist combines robust financial data with an AI-driven personalization engine that delivers tailored welcome messages and daily news summaries directly to your inbox.
| Feature | Description |
|---|---|
| 📊 Real-Time Market Data | Live stock prices, quotes, and company profiles via Finnhub API |
| 📈 TradingView Charts | Professional candlestick, baseline, and technical analysis charts embedded directly |
| ⭐ Smart Watchlists | Build and manage personalized stock watchlists with one-click add/remove |
| 🔍 Intelligent Search | Fast stock discovery with instant search and popular suggestions |
| 🤖 AI-Powered Emails | Personalized welcome messages generated by Google Gemini AI |
| 📰 Daily News Digest | Automated AI-curated market news summaries delivered to your inbox |
| 🔐 Secure Authentication | Email/password auth with Better Auth and MongoDB session management |
| 🌙 Dark Mode | Eye-friendly dark theme optimized for extended market watching |
| 📱 Responsive Design | Seamless experience across desktop, tablet, and mobile devices |
📸 Screenshots showcase the key features of Signalist. Add high-quality screenshots for maximum impact.
| Dashboard | Stock Details |
|---|---|
 |
 |
| TradingView widgets: Market Overview, Heatmap, Top Stories | Candlestick charts, Technical Analysis, Company Profile |
| Watchlist | Search Modal |
|---|---|
 |
 |
| Track your favorite stocks with real-time prices | Instant search with quick add to watchlist |
| Sign Up | Sign In |
|---|---|
 |
 |
| Personalized onboarding with investment preferences | Clean, secure authentication flow |
| Technology | Purpose |
|---|---|
| ⚛️ Next.js 16 | React framework with App Router and Server Components |
| 📘 TypeScript 5.9 | Type-safe development with strict mode |
| 🎨 Tailwind CSS 4.1 | Utility-first styling with dark mode support |
| 🧩 Radix UI | Accessible, unstyled component primitives |
| 🎭 Lucide Icons | Beautiful, consistent icon library |
| Technology | Purpose |
|---|---|
| 🍃 MongoDB 7.0 | Document database for flexible data storage |
| 🔷 Mongoose 9.0 | Elegant MongoDB object modeling |
| 🔐 Better Auth | Self-hosted authentication with session management |
| 📧 Nodemailer | Email delivery for notifications |
| Service | Purpose |
|---|---|
| 📈 Finnhub API | Real-time stock data, company profiles, and news |
| 📊 TradingView | Professional charting widgets and market visualization |
| 🤖 Google Gemini AI | Personalized content generation for emails |
| ⚡ Inngest | Background job orchestration for scheduled tasks |
| Technology | Purpose |
|---|---|
| 📊 Vercel Analytics | Performance monitoring and insights |
| 📦 Bundle Analyzer | Webpack bundle size optimization |
| 🔒 Security Headers | X-Frame-Options, CSP, and more |
Ensure you have the following installed:
- Node.js 18.x or higher
- npm
- MongoDB instance (local or Atlas)
-
Clone the repository
git clone https://github.com/chayan-1906/Signalist-Next.js.git cd Signalist-Next.js -
Install dependencies
npm install
-
Configure environment variables
Copy the example environment file and fill in your credentials:
cp .env.example .env
-
Set up environment variables
# App Configuration NODE_ENV=development NEXT_PUBLIC_BASE_URL=http://localhost:3000 # Database (MongoDB Atlas recommended) MONGODB_URI=mongodb+srv://username:[email protected]/signalist # Authentication (Better Auth) BETTER_AUTH_SECRET=your-secret-key-minimum-32-characters-long BETTER_AUTH_URL=http://localhost:3000 # Google Gemini AI (for personalized emails) GEMINI_API_KEY=your-gemini-api-key # Finnhub Stock API (https://finnhub.io/) NEXT_PUBLIC_FINNHUB_API_KEY=your-finnhub-api-key # Email Configuration (Gmail with App Password) NODEMAILER_EMAIL=[email protected] NODEMAILER_PASSWORD=your-16-char-app-password NEXT_PUBLIC_SUPPORT_EMAIL=[email protected]
-
Start the development server
npm run dev
-
Start Inngest Dev Server (for background jobs)
npx inngest-cli@latest dev
-
Open the app
Navigate to http://localhost:3000
signalist/
├── app/ # Next.js App Router
│ ├── (root)/ # Main application routes
│ │ ├── page.tsx # Dashboard with TradingView widgets
│ │ ├── stocks/[symbol]/ # Dynamic stock details page
│ │ ├── watchlist/ # User's watchlist
│ │ ├── search/ # Search results page
│ │ └── @modal/ # Parallel route for search modal
│ ├── (auth)/ # Authentication routes
│ │ ├── sign-up/ # Registration with preferences
│ │ └── sign-in/ # Login page
│ └── api/inngest/ # Inngest webhook endpoint
│
├── components/ # React components
│ ├── ui/ # Shadcn/Radix UI primitives
│ ├── forms/ # Form input components
│ ├── Header.tsx # Navigation header
│ ├── SearchModal.tsx # Stock search modal
│ ├── TradingViewWidget.tsx # Chart widget wrapper
│ └── WatchlistTable.tsx # Watchlist display
│
├── lib/ # Utilities & configurations
│ ├── actions/ # Server actions
│ │ ├── auth.actions.ts # Authentication logic
│ │ ├── watchlist.actions.ts # Watchlist operations
│ │ └── finnhub.actions.ts # Stock data fetching
│ ├── inngest/ # Background job definitions
│ │ ├── functions.ts # Welcome email, daily news
│ │ └── prompts.ts # AI prompt templates
│ ├── better-auth/ # Auth configuration
│ └── nodemailer/ # Email templates
│
├── database/ # Database configuration
│ ├── mongodb.ts # MongoDB client
│ ├── mongoose.ts # Mongoose connection
│ └── models/ # Mongoose schemas
│
├── hooks/ # Custom React hooks
├── types/ # TypeScript definitions
└── public/ # Static assets
The dashboard provides a comprehensive market overview with embedded TradingView widgets:
- Market Overview — 12-month price action for major indices
- Stock Heatmap — Visual sector-based market performance
- Top Stories — Real-time market news timeline
- Market Quotes — Live quotes across financial, tech, and service sectors
Deep-dive into any stock with professional analysis tools:
- Symbol Info — Company name, exchange, and basic info
- Candlestick Chart — Daily OHLC price action
- Baseline Chart — Long-term trend visualization
- Technical Analysis — Key indicators and signals
- Company Profile — Business description and fundamentals
- Financials — Key financial metrics and ratios
- Add stocks directly from search or stock detail pages
- View real-time prices, changes, market cap, and P/E ratios
- Remove stocks with one click
- Unique constraint prevents duplicates
- Welcome Emails — AI-generated personalized introductions based on user preferences
- Daily News Digest — Automated 12 PM UTC emails with curated news from watchlist stocks
- Preference-Based — Content tailored to investment goals, risk tolerance, and industry preferences
- 🔒 HTTP-only cookies for session management
- 🛡️ Security headers (X-Frame-Options, X-Content-Type-Options, Referrer-Policy)
- 🔑 Password hashing via Better Auth
- ✅ Input validation on all user actions
- 🚫 Rate limiting on API endpoints
- ⚡ Server Components — Reduced client-side JavaScript
- 🗄️ Data Caching — Finnhub API responses cached for performance
- 📦 Bundle Analysis — Continuous bundle size monitoring
- 🖼️ Image Optimization — Next.js automatic image optimization
- 🔄 Parallel Routes — Search modal without navigation overhead
| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production |
npm run start |
Start production server |
npm run lint |
Run ESLint |
npm run analyze |
Analyze bundle size |
- Push your code to GitHub
- Import project in Vercel Dashboard
- Add all environment variables
- Deploy
-
Build the production bundle:
npm run build
-
Start the server:
npm run start
-
Configure Inngest for production background jobs
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License. See the LICENSE file for details.
Padmanabha Das
Built with ❤️ using Next.js, TypeScript, and TradingView
⭐ Star this repo if you found it helpful! ⭐
Track smarter. Invest better.