Skip to content

XYIAN/market-mage

Repository files navigation

Market-Mage 🧙‍♂️

AI-Powered Stock Dashboard with Real-Time Market Insights

Market-Mage is a modern, responsive stock dashboard that combines real-time market data with AI-powered trading insights. Built with a focus on user experience and professional design, it provides traders and investors with the tools they need to make informed decisions.

Market-Mage Dashboard Next.js TypeScript PrimeReact

✨ What Market-Mage Does

Market-Mage transforms how you interact with financial markets by providing:

  • Real-time stock tracking with live price updates and performance metrics
  • AI-powered trading insights that help you make informed decisions
  • Live market news delivered through a smooth scrolling ticker
  • Portfolio management tools to track your investments
  • Professional analytics with charts and historical data

🚀 Getting Started

First Steps

  1. Open the Dashboard: Click the SpeedDial button (bottom-right) to access your stock dashboard
  2. Add Your Stocks: Use the "Add Stock" feature to track your favorite companies
  3. Get AI Insights: Check the AI Oracle for daily trading suggestions
  4. Monitor News: Watch the live news ticker for market updates
  5. Analyze Performance: Use charts and historical data to track trends

Key Features Explained

📊 Stock Dashboard

  • View real-time stock prices, changes, and percentages
  • Sort and filter your watchlist
  • Track portfolio gains and losses
  • Export your data to CSV

🤖 AI Oracle

  • Receive daily AI-powered trading insights
  • Get market analysis and trend predictions
  • Track historical notes and learn from past decisions
  • Generate new insights when needed

📰 Live News Feed

  • Real-time financial news updates
  • Smooth infinite scrolling display
  • Source attribution and timestamps
  • Always visible at the top of the screen

📈 Analytics & Charts

  • Interactive stock performance charts
  • Technical analysis indicators
  • Historical data visualization
  • Responsive design for all devices

🎨 User Experience

Design Highlights

  • Dark Professional Theme: Easy on the eyes for extended use
  • Mobile-First Design: Works perfectly on phones, tablets, and desktops
  • Intuitive Navigation: SpeedDial provides quick access to all features
  • Smooth Animations: Polished interactions and transitions
  • Fast Performance: Optimized for quick loading and responsiveness

Navigation Guide

  • 🏠 Home: Overview of features and capabilities
  • 📊 Dashboard: Main stock tracking and management
  • 📰 News: Detailed news with charts and analysis
  • 🪙 Crypto: Cryptocurrency tracking and news
  • ❓ FAQ: Help and frequently asked questions

🎯 Perfect For

Individual Traders

  • Track personal stock portfolios
  • Get AI-powered trading suggestions
  • Monitor market news and trends
  • Analyze historical performance

Investors

  • Research potential investments
  • Monitor market conditions
  • Track portfolio performance
  • Access professional insights

Financial Enthusiasts

  • Learn about market dynamics
  • Practice portfolio management
  • Stay informed with real-time news
  • Explore AI-powered analysis

🔮 What's Coming Next

  • Real-time portfolio alerts and notifications
  • Advanced charting tools and indicators
  • Social trading features and community insights
  • Mobile app for iOS and Android
  • Enhanced AI insights with more detailed analysis
  • API rate limit optimizations for better performance

🔧 Technical Stack

Frontend

  • Next.js 15.3.4 - React framework with App Router
  • TypeScript 5 - Type-safe development
  • PrimeReact 10.7.0 - Professional UI components
  • Tailwind CSS - Utility-first styling
  • Chart.js - Data visualization

Backend & APIs

  • OpenAI API - AI-powered insights
  • Alpha Vantage - Real-time stock data
  • Next.js API Routes - Server-side functionality

Development Tools

  • ESLint - Code quality and consistency
  • PostCSS - CSS processing
  • Turbopack - Fast development builds

👨‍💻 Developer

Kyle - Full-Stack Developer & Financial Technology Enthusiast

Connect With Me

  • 🌐 Website: [Your Website URL]
  • 💼 LinkedIn: [Your LinkedIn Profile]
  • 🐙 GitHub: [Your GitHub Profile]
  • 📧 Email: [Your Email]

Support & Contribution

If you find Market-Mage helpful, consider:

  • ⭐ Starring this repository
  • 🐛 Reporting bugs or issues
  • 💡 Suggesting new features
  • 🤝 Contributing to the project

Disclaimer: Market-Mage is for educational and informational purposes only. It does not constitute financial advice. Always conduct your own research and consult with financial professionals before making investment decisions.

Built with ❤️ using modern web technologies

About

Market-Mage is an AI-powered stock tracking dashboard that combines real-time prices, daily trading insights, and a live news ticker — all with a touch of wizardry. Built with Next.js, PrimeReact, Tailwind, and OpenAI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors