{"name":"OpenStock: Free, Open-Source Stock Market Tracking with Real-Time Data","description":"OpenStock offers a powerful, open-source alternative to costly market platforms, enabling users to track real-time stock prices and set personalized alerts. Built with Next.js and TypeScript, it provides detailed company insights and a polished user interface, making financial tracking accessible and free for everyone.","github":"https://github.com/Open-Dev-Society/OpenStock","url":"https://osrepos.com/repo/open-dev-society-openstock","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/open-dev-society-openstock","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/open-dev-society-openstock.md","json":"https://osrepos.com/repo/open-dev-society-openstock.json","topics":["stock-market","nextjs","tailwindcss","typescript","open-source","finance","shadcn-ui","inngest"],"keywords":["stock-market","nextjs","tailwindcss","typescript","open-source","finance","shadcn-ui","inngest"],"stars":null,"summary":"OpenStock offers a powerful, open-source alternative to costly market platforms, enabling users to track real-time stock prices and set personalized alerts. Built with Next.js and TypeScript, it provides detailed company insights and a polished user interface, making financial tracking accessible and free for everyone.","content":"## Introduction\nOpenStock is a modern, open-source stock market application designed to provide a free alternative to expensive proprietary platforms. Developed by the Open Dev Society, it embodies a mission to make technology and knowledge accessible to all, without paywalls or subscriptions. This platform allows users to track real-time stock prices, set personalized alerts, and delve into detailed company insights, all within a user-friendly interface powered by Next.js, shadcn/ui, and Tailwind CSS.\n\n## Installation\nTo get OpenStock up and running, follow these quick steps:\n\n### Prerequisites:\n*   Node.js 20+ and pnpm or npm\n*   MongoDB connection string (Atlas or local via Docker Compose)\n*   Finnhub API key (free tier supported)\n*   Gmail account for email (or update Nodemailer transport)\n*   Optional: Google Gemini API key (for AI-generated welcome intros)\n\n### Clone and Install:\nbash\ngit clone https://github.com/Open-Dev-Society/OpenStock.git\ncd OpenStock\n\n# choose one:\npnpm install\n# or\nnpm install\n\n\n### Configure Environment:\nCreate a `.env` file at the project root. Refer to the official repository's `Environment Variables` section for detailed configuration.\n\n### Run Development:\nbash\n# Next.js dev (Turbopack)\npnpm dev\n# or\nnpm run dev\n\nOpen [http://localhost:3000](http://localhost:3000) to view the app. For local Inngest workflows, run `npx inngest-cli@latest dev` in a separate terminal.\n\n## Examples\nOpenStock provides a rich set of features for managing your stock market interactions:\n*   **Authentication:** Secure email/password authentication with protected routes.\n*   **Global Search:** A fast search functionality, including a Command + K palette, to find stocks backed by Finnhub.\n*   **Watchlist:** Create and manage a personalized watchlist to monitor your preferred stocks.\n*   **Stock Details:** Access comprehensive information including TradingView charts, company profiles, and financial widgets.\n*   **Market Overview:** View a market heatmap, quotes, and top stories through integrated TradingView widgets.\n*   **Personalized Alerts:** Receive AI-personalized welcome emails and daily news summaries tailored to your watchlist.\n\n## Why Use OpenStock?\nOpenStock stands out as a compelling choice for several reasons:\n*   **Completely Free and Open-Source:** Adhering to the Open Dev Society's manifesto, it promises to never lock knowledge or charge for access, making advanced market tracking available to everyone.\n*   **Real-Time Data:** Track stock prices and market trends with data from Finnhub and TradingView widgets.\n*   **Modern Tech Stack:** Built with cutting-edge technologies like Next.js 15, TypeScript, Tailwind CSS, and MongoDB, ensuring a robust and scalable application.\n*   **User-Centric Features:** From personalized watchlists and alerts to a polished dark-themed UI, OpenStock is designed for an intuitive and efficient user experience.\n*   **Community-Driven:** It encourages contributions from developers of all skill levels, fostering a welcoming environment for growth and collaboration.\n\n## Links\n*   **GitHub Repository:** [https://github.com/Open-Dev-Society/OpenStock](https://github.com/Open-Dev-Society/OpenStock)","metrics":{"detailViews":11,"githubClicks":7},"dates":{"published":null,"modified":"2026-01-15T08:01:31.000Z"}}