Home
Softono
klickbee-crm

klickbee-crm

Open source TypeScript
56
Stars
4
Forks
0
Issues
1
Watchers
6 months
Last Commit
CRM

About klickbee-crm

Monolithic open-source CRM β€” If life was simple as this CRM, we would all be happy

Platforms

Web Self-hosted

Languages

TypeScript

Klickbee CRM

A demo is better than a thousand words

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

License Build Version Made by Stralya

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
  1. Install dependencies:
npm install
  1. Copy and configure the environment file:
cp .env.example .env
  1. 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
  1. 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.


Klickbee CRM. Organize, track, and grow smarter.