📈 Snap-Stock

A sleek and responsive real-time Korean stock monitoring dashboard built with Next.js, NextUI, and Firebase.

🔗 Live Demo: snap-stock-mocha.vercel.app

---

📢 [Overview]

• 📊 Grouping stocks by sector and market
• 🕒 Real-time price updates
• 🔍 Intelligent stock search with code autocomplete
• ⭐ Add and manage your favorite stocks
• 🎨 Light / Dark mode support
• 🔔 Toast alerts for real-time feedback
• 🔒 User-specific data stored in Firebase
  
  

---

🛠️ Stacks

🛠 How to started

Prerequisites

• Node.js v18 or higher
• Firebase project (for backend features)

Installation

git clone https://github.com/ahnshy/snap-stock.git
cd snap-stock
npm install
# or yarn or pnpm

Environment Setup

Create a .env.local file with your Firebase credentials:

NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_auth_domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_storage_bucket
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id

Development

next dev

Open your browser to http://localhost:3000

---

📁 Folder Tree

snap-stock/
├── app/            # Next.js App Router structure
├── components/     # Reusable UI components
├── config/         # Firebase and other config files
├── data/           # Static stock grouping definitions
├── styles/         # Tailwind and global styles
├── types/          # TypeScript type declarations
├── public/         # Static assets (icons, logos)
└── ...

---

💻 [Preview]

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.