bananefre/stock-market-app

Stock-Market-app, also called Signalist in its own text, is a stock market tracking application built as the companion project for a JavaScript Mastery tutorial series on YouTube. It lets a user watch real time stock prices, set up personalized alerts, look at company financial details, and manage a watchlist of stocks they care about. The app is built with Next.js for the web framework, Shadcn for pre-built interface components, TailwindCSS for styling, and TypeScript throughout. Better Auth handles account sign in, including email and password login plus social sign on through providers like Google, GitHub, and Apple. MongoDB stores the app's data. Finnhub, a market data service, supplies the real time stock, forex, and news data the app displays. Inngest runs the background workflows, such as sending automated alerts, generating AI written daily digests, and delivering earnings notifications, while Nodemailer sends the resulting emails. On the features side, users get a dashboard with interactive line and candlestick charts and filters by industry or market cap, a search tool for finding stocks, a watchlist with configurable price and volume alert thresholds, and a company insights view showing metrics like PE ratio, earnings per share, revenue, and analyst ratings. There is also an admin dashboard for managing stock listings, publishing news, and viewing user activity, plus AI generated market summaries and sentiment scoring on top of the raw data. To run the project locally, you need Git, Node.js, and npm installed. You clone the repository, run npm install, and create a .env file with the required configuration values before starting the app. The README notes an active Discord community for people following along with the tutorial who need help setting things up. This project suits someone learning to build a full stack Next.js application with authentication, a real database, and event driven background jobs, using a stock tracking app as the example, rather than someone looking for a finished trading product to use as is.