A Modern, Full-Stack CRM Platform for Managing Sales Leads
Features β’ Demo β’ Installation β’ Tech Stack β’ Deployment
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.
- π― 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
- Email/Password registration and login
- Google OAuth integration
- Session persistence
- Protected routes
- Secure logout
- 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
- 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
- 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
- Automatic audit trail
- Track all CRUD operations
- User attribution
- Timestamp tracking
- Detailed change logs
- Profile Management - Update display name and photo
- Security - Change password
- Notifications - Email and push preferences
- Data Export - Download complete CRM data
- Privacy - Account deletion
- 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
- Firebase Authentication - User management
- Cloud Firestore - NoSQL database
- Firebase Hosting - Deployment (optional)
- Firestore Security Rules - Data protection
- Node.js 18+ and pnpm
- Firebase account
- Git
git clone https://github.com/YOUR_USERNAME/leadflow-pro.git
cd leadflow-propnpm install- Create a Firebase project at firebase.google.com
- Enable Authentication (Email/Password and Google)
- Create a Firestore database
- Copy your Firebase config
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_idfirebase deploy --only firestore:rules
firebase deploy --only firestore:indexespnpm devVisit http://localhost:5173
pnpm buildThe production build will be in the dist/ folder.
pnpm preview-
Login to Firebase
firebase login
-
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
-
Build & Deploy
pnpm build firebase deploy --only hosting
Your app will be live at: https://YOUR_PROJECT.web.app
- Vercel: Connect GitHub repo and deploy
- Netlify: Drag & drop
distfolder or connect GitHub - GitHub Pages: Use
gh-pagesbranch
{
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;
}{
id: string;
userId: string;
userName: string;
leadId: string;
action: "CREATED" | "UPDATED" | "DELETED" | "MOVED";
details: string;
timestamp: Timestamp;
}- 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
pnpm testpnpm lintleadflow-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
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Your Name
β Star this repo if you find it helpful!
Made with β€οΈ using React & Firebase


