Fin360 is a modern stock analytics application that provides real-time and historical stock data. Designed for investors, it offers interactive visualizations, a customizable dashboard, and dark mode support.
- Real-Time Stock Data: View up-to-date stock prices, daily changes, and market trends via the Alpha Vantage API.
- Historical Data Visualization: Analyze trends with interactive charts for various timeframes.
- Multi-Stock Comparison: Compare multiple stocks with detailed visualizations.
- Customizable Dashboard: Set default stocks and preferences for a personalized experience.
- Dark Mode Support: Switch between light and dark themes for better accessibility.
- Caching Mechanism: Save and reuse data locally to optimize API usage and performance.
- React: Component-based UI framework.
- TypeScript: Ensures type safety and robust development.
- Vite: Fast and modern build tool for React.
- Tailwind CSS: Utility-first CSS framework for responsive and clean design.
- Alpha Vantage API: Provides stock market data for real-time and historical trends.
- Firebase Hosting: Secure and scalable hosting platform for web apps.
Follow these steps to run Fin360 locally.
- Node.js (v16+ recommended)
- NPM (comes with Node.js)
- Alpha Vantage API Key (Get it here)
-
Clone the Repository
git clone https://github.com/<your-username>/fin360.git cd fin360
-
Install Dependencies
npm install
-
Add API Key Create a
.envfile in the root directory and add your Alpha Vantage API key:VITE_API_KEY=your_api_key_here -
Start Development Server
npm run dev
-
Build for Production
npm run build
-
Serve Locally
npx serve dist
Visit the live version of the app: Fin360 Live Demo
- View real-time stock prices, daily changes, and other key metrics.
- Add and customize default stocks for quick access.
- Compare multiple stocks with interactive historical charts.
- Customize timeframes (1 month, 3 months, 6 months, etc.).
- Toggle dark mode.
- Set default stocks and time ranges.
- Enable or disable notifications.
We welcome contributions to improve Fin360! Please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bugfix:
git checkout -b feature/your-feature-name
- Commit your changes:
git commit -m "Add your commit message here" - Push to your branch:
git push origin feature/your-feature-name
- Open a pull request on GitHub.
- Add support for additional APIs (e.g., Yahoo Finance, NSE India).
- Integrate email notifications for stock price alerts.
- Enhance caching mechanism with IndexedDB.
- Mobile-responsive layout improvements.
This project is licensed under the MIT License. See the LICENSE file for more details.
- Alpha Vantage API for real-time and historical stock data.
- Tailwind CSS for sleek and responsive design.
- Firebase for seamless deployment and hosting.