Klickbee CRM
The open-source CRM built for agencies, freelancers, and digital businesses.
🧠 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
- Clone the repository:
git clone https://github.com/Klickbee/klickbee-crm.git
cd klickbee-crm
- Install dependencies:
npm install
- Copy and configure the environment file:
cp .env.example .env
- 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.
- Build the application:
npm run build
Migrate the database :
npx prisma migrate deploy
- 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.
- Fork the repository
- Create a feature branch
- Commit using Conventional Commits
- 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.
- ✉️ [email protected]
- 💬 Discord
- 🌎 stralya.com (coming soon)
- 🌎 klickbee.com
Klickbee CRM. Organize, track, and grow smarter.