Atomic CRM: A Full-Featured CRM with React, shadcn/ui, and Supabase

Atomic CRM: A Full-Featured CRM with React, shadcn/ui, and Supabase

Summary

Atomic CRM is an open-source, full-featured Customer Relationship Management system built using React, shadcn/ui, and Supabase. It offers robust functionalities for organizing contacts, managing deals, creating tasks, and tracking activity history. This project provides a comprehensive solution for businesses looking for a customizable and powerful CRM.

Repository Info

Updated on May 26, 2026
View on GitHub

Tags

Click on any tag to explore related repositories

Introduction

Atomic CRM is a powerful, open-source Customer Relationship Management (CRM) system designed to streamline business operations. Built with modern web technologies like React, shadcn/ui, and Supabase, it provides a comprehensive suite of tools for managing contacts, tracking sales pipelines, and organizing daily tasks. With over 1,000 stars on GitHub, Atomic CRM is a community-backed project developed in TypeScript, offering a robust and flexible foundation for your CRM needs. You can explore its capabilities firsthand by visiting the live demo.

Key Features and How to Use

Atomic CRM is packed with features to help businesses manage their customer relationships effectively. Here's a glimpse of what it offers:

  • Organize Contacts: Keep all your contacts in one easily accessible place, complete with detailed profiles.
  • Create Tasks & Set Reminders: Never miss a follow-up or deadline with integrated task management and reminders.
  • Take Notes: Capture important details and insights effortlessly, linking them directly to contacts or deals.
  • Capture Emails: Automatically save communications as notes by simply CC'ing Atomic CRM.
  • Manage Deals: Visualize and track your sales pipeline using an intuitive Kanban board interface.
  • Import & Export Data: Easily transfer contacts and other data in and out of the system.
  • Control Access: Securely log in with various providers including Google, Azure, Keycloak, and Auth0.
  • Track Activity History: View all interactions and changes in aggregated activity logs for a complete overview.
  • Integrate via API: Connect seamlessly with other systems using its flexible API.
  • Customize Everything: Add custom fields, change the theme, and replace any component to fit your specific business needs.

Installation

To get Atomic CRM up and running on your local machine, follow these steps. You'll need Make, Node 22 LTS, and Docker (for Supabase) installed.

  1. Fork and Clone the Repository:
    Fork the marmelab/atomic-crm repository to your GitHub account, then clone it locally:

    git clone https://github.com/[username]/atomic-crm.git
    
  2. Install Dependencies:
    Navigate into the cloned directory and install the necessary dependencies for both the frontend and backend, including a local Supabase instance:

    cd atomic-crm
    make install
    
  3. Start the Application:
    Once dependencies are installed and configured, start the application:

    make start
    

    This command launches the Vite dev server for the frontend, the local Supabase instance for the API, and a Postgres database. You can then access the application via http://localhost:5173/. You will be prompted to create the first user upon your initial visit.

Why Use Atomic CRM?

Atomic CRM stands out as an excellent choice for businesses and developers alike due to several compelling reasons:

  • Open Source and Free: It's completely free to use and modify, offering full transparency and control.
  • Modern Technology Stack: Leveraging React, shadcn/ui, and Supabase ensures a performant, scalable, and maintainable application.
  • Highly Customizable: From custom fields to theme changes and component replacements, Atomic CRM is designed to adapt to your unique workflows.
  • Comprehensive Feature Set: It covers all essential CRM functionalities, from contact and deal management to task tracking and email capture.
  • Developer-Friendly: With clear installation instructions, extensive documentation, and an API, developers can easily integrate and extend its capabilities.
  • Community Support: Backed by a growing community and maintained by Marmelab, you benefit from ongoing development and support.

Links