🚀 Salesforce CRM Clone

A full-featured CRM application built with modern web technologies, replicating the Salesforce Lightning Experience.

🌐 Live Demo · 📖 Documentation · 🐛 Report Bug · ✨ Request Feature

---

✨ Features

Module	Description
Landing Page	Pixel-perfect clone of Salesforce homepage with hero, testimonials, and CTAs
Authentication	Secure sign-up/sign-in with Clerk (email, Google, GitHub)
Dashboard Home	Onboarding wizard, quick actions, pinned lists
Leads Management	Create, track, and convert leads with status workflows
Accounts	Company/organization management with industry classification
Contacts	Contact management linked to accounts
Opportunities	Sales pipeline with Kanban board view
Service Cases	Customer support ticket tracking

---

🖼️ Screenshots

Landing Page

Sign Up

---

🛠️ Tech Stack

Category	Technologies
Framework	Next.js 16 (App Router, Turbopack)
Language	TypeScript
Styling	Tailwind CSS, Shadcn UI
Authentication	Clerk
Database	Neon PostgreSQL (Serverless)
ORM	Drizzle ORM
Validation	Zod
Deployment	Vercel

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• PostgreSQL database (Neon recommended)
• Clerk account

Installation

# Clone the repository
git clone https://github.com/ihatesea69/salesforce-crm-clone.git
cd salesforce-crm-clone

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your credentials

# Run database migrations
npm run db:generate
npm run db:push

# Start development server
npm run dev

Open http://localhost:3000 to view the app.

Environment Variables

# Database (Neon PostgreSQL)
DATABASE_URL="postgresql://..."

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="pk_..."
CLERK_SECRET_KEY="sk_..."

# Clerk URLs
NEXT_PUBLIC_CLERK_SIGN_IN_URL="/sign-in"
NEXT_PUBLIC_CLERK_SIGN_UP_URL="/sign-up"
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL="/dashboard"
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL="/dashboard"

---

📁 Project Structure

├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (auth)/             # Authentication pages
│   │   ├── dashboard/          # CRM modules
│   │   │   ├── accounts/
│   │   │   ├── contacts/
│   │   │   ├── leads/
│   │   │   ├── opportunities/
│   │   │   └── cases/
│   │   └── page.tsx            # Landing page
│   ├── components/
│   │   ├── dashboard/          # List views, empty states
│   │   ├── layout/             # Sidebar, header
│   │   └── ui/                 # Shadcn components
│   └── lib/
│       ├── actions/            # Server actions
│       ├── db/                 # Database schema
│       └── validations/        # Zod schemas
├── public/
│   └── images/                 # Generated assets
└── tests/                      # Vitest + Playwright

---

📜 Scripts

Script	Description
npm run dev	Start development server
npm run build	Build for production
npm run start	Start production server
npm run lint	Run ESLint
npm run type-check	TypeScript type checking
npm run test	Run unit tests (Vitest)
npm run test:e2e	Run E2E tests (Playwright)
npm run db:generate	Generate Drizzle migrations
npm run db:push	Push schema to database

---

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide first.

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

---

📄 License

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

---

🙏 Acknowledgments

• Salesforce - Design inspiration
• Shadcn UI - UI components
• Clerk - Authentication
• Neon - Serverless PostgreSQL
• Vercel - Deployment

---

⭐ Star this repo if you find it helpful!

Made with ❤️ by @ihatesea69