advisor
quiz
mock portfolio
personalized learning
mock portfolio
landing page

EquityHer

AI-Powered Investment Mentor

EquityHer is a platform designed to help women build financial confidence. It allows users to learn investing without financial risk. The application combines personalized AI mentorship with interactive learning modules. Users can also access a virtual trading simulator. This creates an environment suitable for financial growth and education.

Live Demo

The application is deployed at www.equityher.tech.

Features

AI Mentorship: Users receive answers to investing questions at any time. The AI guide is powered by Google Gemini and provides knowledgeable responses.
Risk-Free Practice: The platform provides $10,000 in virtual cash. This allows for experimentation with stock trading strategies without the risk of losing real money.
Personalized Learning: Lessons are tailored to the user's knowledge level. Content ranges from basic concepts to advanced strategies.
Portfolio Dashboard: Users can track virtual holdings and monitor performance. The system provides AI-driven feedback on portfolio diversity and risk factors.
Interactive Chat: The interface supports natural conversations with the AI mentor. This helps clarify doubts and obtain market insights.

Tech Stack

Framework: Next.js 16 (App Router)
Language: TypeScript
Styling: Tailwind CSS
UI Components: Shadcn UI (Radix UI)
AI Integration: Google Generative AI (Gemini)
State Management: Zustand
Charts: Recharts
Icons: Lucide React

Getting Started

Follow these steps to set up the project locally.

Prerequisites

Node.js (v18 or higher)
npm, yarn, pnpm, or bun

Installation

Clone the repository:

git clone https://github.com/Khushal-Me/equityher.git
cd equityher

Install dependencies:

npm install
# or
yarn install
# or
pnpm install

Set up environment variables:

Create a .env.local file in the root directory. Add your API keys as shown below.
```
NEXT_PUBLIC_GEMINI_API_KEY=your_gemini_api_key_here
```

Run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev

Open the app:

Visit http://localhost:3000 in your browser.

Project Structure

equityher/
├── src/
│   ├── app/              # Next.js App Router pages and layouts
│   │   ├── chat/         # AI Chat interface
│   │   ├── dashboard/    # User dashboard
│   │   ├── learn/        # Learning modules
│   │   └── portfolio/    # Portfolio management
│   ├── components/       # Reusable UI components
│   │   ├── chat/         # Chat-specific components
│   │   ├── layout/       # Layout components (Navbar, etc.)
│   │   ├── learning/     # Learning-specific components
│   │   ├── portfolio/    # Portfolio-specific components
│   │   └── ui/           # Shadcn UI primitives
│   ├── lib/              # Utility functions and API configurations
│   ├── store/            # Zustand state stores
│   └── types/            # TypeScript type definitions
├── public/               # Static assets
└── ...config files