Forget boring stock tools, this is your personal AI financial guru!
AI that actually understands what you're looking for!
What it does:
- Understands company names, tickers, and descriptions.
- Autocomplete that actually helps you.
- Instant results with all the company info.
- Quick shortcut: just press
/anywhere!
Your own pro trading screen with real-time data.
What it does:
- Prices update live with cool animations.
- See who's winning and losing in the market.
- Find out what stocks are hot right now.
- Knows if the market's open or closed, no matter where you are.
- Looks super sleek with a dark theme.
AI reads the news and tells you how it feels about stocks.
What it does:
- Gives news a score (1-10) and tells you why.
- Explains how news impacts the market.
- Pulls out the good and bad parts of articles.
- Gathers news from everywhere.
- Analyzes up to 10 recent articles in real-time.
Confused by financial jargon? AI breaks it down for you!
What it does:
- One click for AI explanations of any financial term.
- Simple English for complex ratios.
- Easy-to-see indicators (good, bad, neutral).
- Learn as you go with interactive explanations.
- AI chatbot ready to teach you more!
Pro charts with different time views and fancy analysis.
What it does:
- See stock performance over various periods (daily, weekly, monthly, etc.).
- Real-time price data with cool visuals.
- Hover to see exact prices.
- Smooth animations and a polished look.
- Includes technical indicators for deeper dives.
Upload your investments and get smart AI analysis.
What it does:
- Just type in your holdings ("10 Apple shares, 25 Microsoft").
- See your portfolio broken down by sector.
- AI tells you about your risk and suggests improvements.
- Tracks your portfolio value and how it's performing.
- Helps with different investment strategies.
Tell AI your investment goals, and it'll find stocks for you!
What it does:
- Understands your investment criteria in plain English.
- Discovers stocks from thousands of companies.
- Explains why each recommendation is a good fit.
- Works with all sorts of investment themes.
- Links directly to detailed stock analysis.
See how different parts of the market are doing in real-time.
What it does:
- Monitors sector performance live.
- Color-coded strength indicators.
- Shows top performers and laggards in each sector.
- AI gives insights on sector rotation.
- Connects to economic trends.
AI reads official company reports for you, so you don't have to!
What it does:
- Automatically gets and processes SEC filings.
- AI pulls out key business insights.
- Summarizes risks.
- Breaks down management discussions.
- Helps monitor regulatory compliance.
AI tries to predict what's next for your investments.
What it does:
- Uses multiple factors for AI predictions.
- Analyzes growth paths.
- Assesses market opportunities.
- Gives insights into competitor positioning.
- Projects risk-adjusted returns.
Get the scoop on who your stock's rivals are.
What it does:
- Automatically finds competitors.
- Compares financials side-by-side.
- Analyzes market share.
- Helps you understand competitive advantages.
- Gives strategic positioning insights.
Your trading terminal works great on any device!
What it does:
- Designed for mobile first, looks good everywhere.
- Professional dark theme.
- Easy to use with touchscreens.
- Data syncs in real-time.
- Works offline too!
- ⚛️ Next.js — The React framework for production.
- 🎨 TypeScript — Keeps things neat and error-free.
- 🎯 Tailwind CSS — Super flexible styling.
- 🎭 Shadcn/ui — Beautiful, ready-to-use components.
- 📊 Recharts — For all those cool data visualizations.
- 🔄 React Query — Handles data fetching and caching like a pro.
- 🔥 Supabase — Our all-in-one backend solution.
- 🧠 Edge Functions — Serverless AI for smart analysis.
- 🗄️ PostgreSQL — Solid database with real-time updates.
- 🔐 Row Level Security — Keeps your data super safe.
- 📡 Real-time APIs — Live data, always.
- 🤖 GPT-4 Integration — Powered by the best AI for natural language.
- 📈 Financial Data APIs — Real-time market data, always fresh.
- 🔍 News Aggregation — Gathers news from tons of sources.
- 📊 Sentiment Analysis — Custom AI to understand market moods.
- 🎯 Recommendation Engine — AI-powered stock suggestions just for you.
- ⚡ Next.js — The React framework for production.
- 🚀 Vercel — Deploys globally, scales automatically.
- 📦 NPM/Yarn — Easy package management.
- 🔧 ESLint/Prettier — Keeps the code clean and consistent.
- 🧪 TypeScript Strict — Maximum type safety, because we're serious about quality.
- Node.js 18+ and npm installed (nvm guide)
- Git (for version control, obviously!)
# Grab the code
git clone https://github.com/Vicistar-V/vin-stock-ai.git
cd vin-stock-main
# Install all the stuff
npm install
# Start it up!
npm run dev# Copy the example file
cp .env.example .env
# Add your API keys here (check .env.example for what's needed)
# - Supabase stuff (NEXT_PUBLIC_SUPABASE_PROJECT_ID, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY, NEXT_PUBLIC_SUPABASE_URL)
# - Financial data keys
# - AI service keys- 🌐 Development:
http://localhost:3000(Next.js default port) - 🚀 Production: Deploy to Vercel, Netlify, or your favorite platform!
/* Main Colors */
--primary: 220 90% 56% /* Electric Blue */
--primary-foreground: 0 0% 98%
--secondary: 210 40% 8% /* Dark Blue */
--accent: 142 76% 36% /* Success Green */
--destructive: 0 84% 60% /* Error Red */
/* Mood Colors */
--success: 142 76% 36%
--warning: 38 92% 50%
--info: 199 89% 48%
--muted: 217 19% 27%- Big Text: Inter, system-ui
- Regular Text: Inter, system-ui
- Code: Fira Code, Monaco, Consolas
- 📦 50+ Custom Components — Built with Radix UI, super flexible.
- 🎨 Design Tokens — Consistent look and feel everywhere.
- 📱 Responsive Patterns — Works awesome on phones and tablets.
- ♿ Accessibility First — Built for everyone!
- 📊 Real-time Market Data — Live prices, volume, you name it.
- 📰 News Aggregation — All the financial news, all in one place.
- 📋 SEC Filings — Official reports, processed for you.
- 🏢 Company Fundamentals — Financial statements and key numbers.
- 🧠 OpenAI GPT-4 — The brain behind the smarts.
- 📈 Sentiment Analysis — Custom-tuned for finance.
- 🎯 Recommendation Engine — Machine learning for your investments.
- 🔍 Document Processing — Automating financial document analysis.
- Deploy to Vercel, Netlify, or whatever you like.
- Click Share → Publish
- Boom! Your app is live globally! 🎉
- Go to Project → Settings → Domains
- Click Connect Domain
- Follow the simple instructions.
- SSL certificates are handled automatically!
# Build for production
npm run build
# Then deploy wherever:
# - Vercel, Netlify, AWS S3, CloudFlare Pages
# - Docker ready
# - Works with static hosting too!- ⚡ LCP: < 1.2s (Loads super quick!)
- 🎯 FID: < 10ms (Clicks feel instant!)
- 📏 CLS: < 0.1 (No annoying layout shifts!)
- 🚀 TTI: < 2.0s (Ready to use in a flash!)
- 📦 Bundle Size: < 500KB gzipped (Tiny and fast!)
- 🔄 Cache Hit Rate: 95%+ static assets (Blazing fast repeat visits!)
- 📱 Mobile Performance: 95+ Lighthouse score (Mobile-first, baby!)
- 🌐 Global CDN: < 100ms response time worldwide (Fast everywhere!)
# Check for errors and format
npm run lint # ESLint checks
npm run format # Prettier makes it pretty
npm run type-check # TypeScript checks everything
# Testing
npm run test # Unit tests
npm run test:e2e # End-to-end tests
npm run test:coverage # See how much code is covered# Working on a new feature
git checkout -b feature/new-analysis-tool
git commit -m "feat: add sector rotation analysis"
git push origin feature/new-analysis-tool
# Merging to main automatically deploys!- 🔍 React DevTools — Inspect your components.
- 📊 Supabase Dashboard — Monitor your database and API.
- 🌐 Network Inspector — See what your app is doing.
- 📱 Responsive Testing — Check on different devices.
We love contributions! This project gets better with your help.
- 🍴 Fork the repo.
- 🌿 Create your new feature branch.
- 💻 Code something awesome!
- ✅ Add tests for your new stuff.
- 📝 Update the docs if needed.
- 🚀 Send a pull request!
- Follow TypeScript best practices.
- Keep test coverage above 80%.
- Use clear, semantic commit messages.
- Update documentation for new features.
- Make sure it's accessible!
This project is under the MIT License — use it for anything you want, personal or commercial.
- ✅ Personal Projects — Go for it!
- ✅ Commercial Apps — Totally fine!
- ✅ Modifications — Fork and change whatever you like.
- ✅ Distribution — Share it, just give credit.
Built with ❤️ by the VIN STOCK team — Making financial smarts easy with AI.
Every feature uses AI to make complex financial analysis simple for everyone.
Live market data plus instant AI processing means insights at the speed of thought.
Dark, sleek interface that feels like a pro trading terminal — because it basically is!
Built with modern tools, so it's super easy to extend and customize.
Perfect on desktop, tablet, and mobile — your financial smarts, anywhere.
- 📚 Docs: React Docs | Supabase Docs
- 🐛 Bugs: GitHub Issues
- 📧 Contact: support@vinstock.ai
- 🌟 Star this repo if you dig it!
- 🔔 Watch for updates and new features.
- 📧 Newsletter: Get weekly AI development insights.
- 🏅 Open Source — Free for personal and commercial use!
- ⭐ 5-Star Developer Experience — Modern tools, great docs.
- 🚀 Production-Ready — Built for scale, enterprise-level architecture.
- 🌍 Global Performance — Optimized for users worldwide.
Ready to change how you do investment research? This isn't just another stock app — it's your personal AI financial intelligence platform!
⭐ Star on GitHub • 📧 Contact Us • 🚀 Deploy Now
Last updated: January 2025 • Built with Next.js + TypeScript • Powered by AI