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.