Simple-Invest is an open-source alternative to expensive market platforms. Built for students, developers, and individual investors who want powerful market tracking without the subscription fees.
Track real-time prices • Set personalized alerts • Explore company insights • Built openly, for everyone
Note: Simple-Invest is community-built and not a brokerage. Market data may be delayed based on provider rules. Nothing here is financial advice.
|
Secure email/password auth with Better Auth + MongoDB. Protected routes ensure your data stays private. Lightning-fast stock search with Cmd/Ctrl + K shortcut. Popular stocks when idle, instant results as you type. Build and manage your personal watchlist. Each symbol is unique per user and stored securely in MongoDB. |
Interactive TradingView charts, company profiles, financials, and technical indicators — all in one view. Heatmaps, live quotes, and top stories powered by TradingView widgets. AI-personalized welcome emails and daily news summaries based on your watchlist. |
- Dark theme by default with shadcn/ui components
- Radix UI primitives for accessibility
- Tailwind CSS v4 design system
- Smooth animations and transitions
| Requirement | Description |
|---|---|
| MongoDB | Database (Atlas ) |
| Finnhub API | Market data (free tier available) |
| Gmail Account | Email notifications |
| Gemini API | AI-powered features |
# Clone the repository
git clone https://github.com/nishuldhakar/Simple-Invest.git
cd Simple-Invest
# Install dependencies
pnpm install
# or
npm install
# Set up environment variables (see below)
cp .env.example .env
# Test database connection
pnpm test:db
# Start development server
pnpm dev# In a separate terminal
npx inngest-cli@latest devOpen http://localhost:3000 and start exploring!
Create a .env file in the project root:
📋 Click to see environment template
# === Core ===
NODE_ENV=development
# === Database ===
# Option 1: MongoDB Atlas (hosted)
MONGODB_URI=mongodb+srv://<user>:<pass>@<cluster>/<db>?retryWrites=true&w=majority
# Option 2: Local Docker MongoDB
# MONGODB_URI=mongodb://root:example@mongodb:27017/Simple-Invest?authSource=admin
# === Authentication ===
BETTER_AUTH_SECRET=your_better_auth_secret_here
BETTER_AUTH_URL=http://localhost:3000
# === Finnhub API ===
FINNHUB_API_KEY=your_finnhub_key
FINNHUB_BASE_URL=https://finnhub.io/api/v1
# Optional: Client-side access (if needed)
NEXT_PUBLIC_FINNHUB_API_KEY=
# === AI Features (Gemini) ===
GEMINI_API_KEY=your_gemini_api_key
# === Email (Nodemailer) ===
NODEMAILER_EMAIL=youraddress@gmail.com
NODEMAILER_PASSWORD=your_gmail_app_password** Security Tips:**
- Never commit
.envto version control - Use App Passwords for Gmail with 2FA enabled
- Keep
NEXT_PUBLIC_variables minimal (they're exposed to browsers) - Use dedicated SMTP providers in production
|
|
Language Composition: TypeScript (~93.4%) • CSS (~6%) • JavaScript (~0.6%)
Simple-Invest/
├── app/
│ ├── (auth)/ # Authentication pages
│ │ ├── sign-in/
│ │ └── sign-up/
│ ├── (root)/ # Main application
│ │ ├── stocks/[symbol]/ # Stock detail pages
│ │ ├── help/
│ │ └── page.tsx # Dashboard
│ └── api/inngest/ # Inngest webhook
├── components/
│ ├── ui/ # shadcn/ui components
│ ├── forms/ # Form components
│ └── Header.tsx, Footer.tsx, etc.
├── database/
│ ├── models/ # Mongoose models
│ └── mongoose.ts # Database connection
├── lib/
│ ├── actions/ # Server actions
│ ├── better-auth/ # Auth configuration
│ ├── inngest/ # Background jobs
│ └── nodemailer/ # Email templates
├── public/assets/ # Static assets
└── types/ # TypeScript definitions
Real-time and historical market data. Free tier available with rate limits.
Professional-grade charts and market widgets embedded throughout the app.
Modern authentication with MongoDB adapter. Session-based security with middleware protection.
Reliable background job processing:
- Welcome emails on user signup
- Daily news summaries at noon
- AI-powered content via Gemini
| Command | Description |
|---|---|
pnpm dev |
Start development server (Turbopack) |
pnpm build |
Build for production |
pnpm start |
Run production server |
pnpm lint |
Run ESLint |
pnpm test:db |
Test database connection |
You belong here. Whether you're writing your first line of code or your millionth, contributions are welcome.
- Find an issue — Look for
good first issueorhelp wantedlabels - Discuss first — Open an issue to discuss your idea
- Make changes — Keep PRs focused on a single feature/fix
- Add screenshots — For UI changes, show before/after
- Be kind — Guide beginners, no gatekeeping
# Fork and clone the repo
git clone https://github.com/nishuldhakar/Simple-Invest.git
# Create a feature branch
git checkout -b feature/amazing-feature
# Make your changes and commit
git commit -m "Add amazing feature"
# Push and create a Pull Request
git push origin feature/amazing-featureWe live in a world where knowledge is hidden behind paywalls.
We believe there's a better way.
Technology should belong to everyone. Knowledge should be open, free, and accessible. Communities should welcome newcomers with trust, not gatekeeping.
Build free, open-source projects that make a real difference:
- Tools that professionals and students can use without barriers
- Knowledge platforms where learning is free, forever
- Communities where every beginner is guided, not judged
- Resources that run on trust, not profit
We will never lock knowledge. We will never charge for access. We will never trade trust for money. We run on transparency, donations, and the strength of our community.
If you've ever felt you didn't belong, struggled to find free resources, or wanted to build something meaningful — you belong here.
Because the future belongs to those who build it openly.
Built with gratitude for these amazing open-source projects:
- Finnhub for accessible market data
- TradingView for professional market widgets
- shadcn/ui, Radix UI & Tailwind CSS for the beautiful UI foundation
- Next.js and the React community
- Inngest for reliable background jobs
- Better Auth for simple, secure authentication
- All contributors who make open tools possible