Klickbee CRM

The open-source CRM built for agencies, freelancers, and digital businesses.

What does it looks like ?

---

🧠 What is Klickbee CRM?

Klickbee CRM is an open-source CRM built entirely with Next.js. It centralizes customer management, sales tracking, and internal collaboration in a modular, scalable structure.

Built for agencies, freelancers, and businesses who need clarity, sovereignty, and speed.

---

🧩 Architecture

Klickbee CRM follows a Feature-Driven Architecture (FDA) — each feature is self-contained with its own logic, UI, and data layer.

src/
├── app/                     # Next.js App Router
├── components/              # Global components
├── feature/
│   ├── auth/                # Authentication (login, signup, etc.)
│   ├── companies/           # Company management (list, details, forms)
│   ├── customers/           # Customer management
│   ├── dashboard/           # Main dashboard and analytics
│   ├── deals/               # Deals and opportunities tracking
│   ├── meetings/            # Meetings and appointments
│   ├── prospects/           # Prospects and leads management
│   ├── settings/            # App and user settings
│   ├── todo/                # Task and to-do management
│   └── user/                # User management and profiles
├── libs/                    # Utility functions and shared logic
└── types/                   # Global TypeScript types

Each feature manages its own state, components, and API integrations. This approach ensures a clear separation of concerns, making the app maintainable and scalable.

---

🚀 MVP Features

Feature	Description
Companies	Manage organizations and business clients
Contacts	Individual client profiles linked to companies
Deals	Sales pipeline and deal tracking
Activities	Follow-ups, notes, and call logs
Notifications	Toasts and inline feedback for user actions
Forms	React Hook Form + Zod validation for reliability

---

🧠 Tech Stack

Tech	Description
Next.js 15	App Router architecture
React 19	UI layer
TailwindCSS 4 + shadcn/ui	Styling & components
Zustand	Local state management
TanStack Query	Server state & async data handling
Prisma ORM	PostgreSQL / SQLite support
Zod + Yup	Form validation (All yup will be migrate to zod)
NextAuth.js	Authentication
Nodemailer	Email sending

---

⚙️ Getting Started

Option 1: Local Development

1. Clone the repository:

git clone https://github.com/Klickbee/klickbee-crm.git
cd klickbee-crm

2. Install dependencies:

npm install

3. Copy and configure the environment file:

cp .env.example .env

4. Run the development server:

npm run dev

The application runs at localhost:3000

---

Option 2 : Production Deployment

Clone the repo and install dependencies as above.

Copy .env.example to .env and configure it for production.

1. Build the application:

npm run build

Migrate the database :

npx prisma migrate deploy

2. Start the production server:

npm start

or use PM2 for process management:

pm2 start npm --name "klickbee-crm" -- start

We recommend using a reverse proxy like Caddy for better performance and security.

---

🧹 Code Quality & Linting

Klickbee CRM uses ESLint and TypeScript

Tool	Purpose
ESLint	Enforces coding standards
TypeScript	Ensures type safety

---

🧠 Roadmap

Milestone	Status	Description
Company & Contact Management	✅	Core features implemented
Opportunity Pipeline	✅	Implemented
Notes & Activities	✅	Available
Dashboard & Stats	✅	Implemented
Automations & Workflows	🔜	Coming on next release

---

🚧 Contributing

Klickbee CRM is built in the open. Feedback, ideas, and PRs are welcome.

1. Fork the repository
2. Create a feature branch
3. Commit using Conventional Commits
4. Submit a Pull Request 🎯

---

📄 License

This project is licensed under the GNU Affero General Public License v3.0.

---

🌐 Maintained by Stralya

We build tools for digital creators.

• ✉️ contact@stralya.com
• 💬 Discord
• 🌎 stralya.com (coming soon)
• 🌎 klickbee.com

---

Klickbee CRM. Organize, track, and grow smarter.