Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

7 Commits

Folders and files

Repository files navigation

πŸš€ LeadFlow Pro.

LeadFlow Pro Version License

A Modern, Full-Stack CRM Platform for Managing Sales Leads

Features β€’ Demo β€’ Installation β€’ Tech Stack β€’ Deployment


πŸ“‹ Overview

LeadFlow Pro is a comprehensive Customer Relationship Management (CRM) application built with modern web technologies. It provides a complete solution for managing sales leads, tracking activities, and visualizing your sales pipeline with an intuitive Kanban board interface.

✨ Key Highlights

  • 🎯 Intuitive Kanban Board - Drag-and-drop lead management
  • πŸ“Š Real-time Analytics - Track revenue, deals, and conversion rates
  • πŸ” Secure Authentication - Email/Password + Google OAuth
  • πŸ“± Fully Responsive - Works seamlessly on all devices
  • 🎨 Modern UI - Beautiful glassmorphism design
  • πŸ”” Activity Logging - Complete audit trail of all actions
  • πŸ’Ύ Data Export - Download all your CRM data as JSON
  • πŸŒ™ Dark Mode - Easy on the eyes

🎯 Features

πŸ” Authentication

  • Email/Password registration and login
  • Google OAuth integration
  • Session persistence
  • Protected routes
  • Secure logout

πŸ“Š Dashboard

  • Revenue Tracking - Total revenue display
  • Active Deals Counter - Current pipeline count
  • Win Rate Calculator - Conversion metrics
  • Status Distribution Chart - Visual pipeline breakdown
  • Recent Activity Feed - Latest updates
  • Recent Leads List - Quick access to new leads

🎯 Kanban Board

  • Drag & drop interface
  • 4 Pipeline stages: New β†’ Contacted β†’ Proposal β†’ Closed
  • Real-time Firestore sync
  • Visual lead cards with all details
  • Stage value totals
  • Touch-friendly for mobile

πŸ‘₯ Lead Management

  • Create leads with full details
  • Edit existing leads
  • Delete with confirmation
  • Tags system for organization
  • Search and filter capabilities
  • Email and phone tracking
  • Deal value management

πŸ”” Activity Logging

  • Automatic audit trail
  • Track all CRUD operations
  • User attribution
  • Timestamp tracking
  • Detailed change logs

βš™οΈ Settings

  • Profile Management - Update display name and photo
  • Security - Change password
  • Notifications - Email and push preferences
  • Data Export - Download complete CRM data
  • Privacy - Account deletion

πŸ› οΈ Tech Stack

Frontend

  • React 18 - UI library
  • TypeScript - Type safety
  • Vite - Build tool
  • TailwindCSS - Styling
  • Shadcn/ui - Component library
  • React Router v6 - Routing
  • React Hook Form - Forms
  • Zod - Validation
  • Zustand - State management
  • TanStack Query - Server state
  • Recharts - Data visualization
  • dnd-kit - Drag and drop
  • Lucide React - Icons
  • Sonner - Notifications

Backend & Infrastructure

  • Firebase Authentication - User management
  • Cloud Firestore - NoSQL database
  • Firebase Hosting - Deployment (optional)
  • Firestore Security Rules - Data protection

πŸš€ Installation

Prerequisites

  • Node.js 18+ and pnpm
  • Firebase account
  • Git

1. Clone Repository

git clone https://github.com/YOUR_USERNAME/leadflow-pro.git
cd leadflow-pro

2. Install Dependencies

pnpm install

3. Firebase Setup

  1. Create a Firebase project at firebase.google.com
  2. Enable Authentication (Email/Password and Google)
  3. Create a Firestore database
  4. Copy your Firebase config

4. Environment Configuration

Create a .env file in the root directory:

VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
VITE_FIREBASE_PROJECT_ID=your_project_id
VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_id

5. Deploy Firestore Rules & Indexes

firebase deploy --only firestore:rules
firebase deploy --only firestore:indexes

6. Run Development Server

pnpm dev

Visit http://localhost:5173


πŸ“¦ Build for Production

pnpm build

The production build will be in the dist/ folder.

Preview Production Build

pnpm preview

🌐 Deployment

Deploy to Firebase Hosting

  1. Login to Firebase

    firebase login
  2. Initialize Firebase

    firebase init hosting
    • Select your Firebase project
    • Set public directory to dist
    • Configure as single-page app: Yes
    • Don't overwrite index.html: No
  3. Build & Deploy

    pnpm build
    firebase deploy --only hosting

Your app will be live at: https://YOUR_PROJECT.web.app

Deploy to Other Platforms

  • Vercel: Connect GitHub repo and deploy
  • Netlify: Drag & drop dist folder or connect GitHub
  • GitHub Pages: Use gh-pages branch

πŸ”₯ Firestore Structure

Collections

leads

{
  id: string;
  userId: string;
  companyName: string;
  contactName: string;
  email: string;
  phone?: string;
  value: number;
  status: "new" | "contacted" | "proposal" | "closed";
  tags: string[];
  notes?: string;
  createdAt: Timestamp;
  updatedAt: Timestamp;
}

activity_logs

{
  id: string;
  userId: string;
  userName: string;
  leadId: string;
  action: "CREATED" | "UPDATED" | "DELETED" | "MOVED";
  details: string;
  timestamp: Timestamp;
}

πŸ”’ Security

  • Firebase Authentication - Industry-standard auth
  • Firestore Security Rules - Data isolation per user
  • Protected Routes - Unauthorized access blocked
  • Input Validation - Zod schemas throughout
  • XSS Protection - React's built-in escaping
  • HTTPS Only - Enforced by Firebase

πŸ“± Screenshots

Dashboard

Dashboard

Kanban Board

Kanban Board

Settings

Settings


πŸ§ͺ Testing

Run Tests (if implemented)

pnpm test

Lint Code

pnpm lint

πŸ“‚ Project Structure

leadflow-pro/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/       # Reusable UI components
β”‚   β”œβ”€β”€ features/         # Feature-based modules
β”‚   β”‚   β”œβ”€β”€ auth/         # Authentication
β”‚   β”‚   β”œβ”€β”€ board/        # Kanban board
β”‚   β”‚   β”œβ”€β”€ leads/        # Lead management
β”‚   β”‚   β”œβ”€β”€ activity/     # Activity logging
β”‚   β”‚   └── dashboard/    # Dashboard components
β”‚   β”œβ”€β”€ layouts/          # Layout components
β”‚   β”œβ”€β”€ pages/            # Route pages
β”‚   β”œβ”€β”€ lib/              # Utilities & config
β”‚   β”œβ”€β”€ store/            # Zustand stores
β”‚   └── App.tsx           # Main app component
β”œβ”€β”€ public/               # Static assets
β”œβ”€β”€ firestore.rules       # Security rules
β”œβ”€β”€ firestore.indexes.json # Database indexes
└── firebase.json         # Firebase config

🀝 Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“ License

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


πŸ‘¨β€πŸ’» Author

Your Name


πŸ™ Acknowledgments


πŸ“Š Stats

Build Status TypeScript Code Quality


⭐ Star this repo if you find it helpful!

Made with ❀️ using React & Firebase

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages