Repolode
Submit
marmelab

marmelab/atomic-crm

A self-hostable CRM for managing contacts, deals, tasks and notes, built with React, shadcn/ui and Supabase.

Open-source alternative to:SalesforceHubSpot CRM

View on GitHubWebsite
Stars
1,388
Forks
878
Open issues
19
Last commit
4 days ago

What is it?

Atomic CRM is a customer relationship management app that covers the everyday workflow of a sales or account team: a contact list, a Kanban board for tracking deals through a pipeline, tasks with reminders, and notes attached to contacts. It also records an activity history across interactions, and supports importing and exporting contacts.

The frontend is written in React with shadcn/ui components, and the backend runs on Supabase, which provides the Postgres database, API and file storage. Sign-in is available through Google, Azure, Keycloak and Auth0. Emails can be captured by CCing a dedicated address so the messages are saved as notes.

The project is meant to be forked and customized. Custom fields, themes and components can be replaced, and updated components can be pulled into a fork through a shadcn registry. Local development runs with Make, Docker and a local Supabase instance.

Key features

  • 01Manage contacts, tasks with reminders, and notes in one place.
  • 02Track deals on a Kanban pipeline board.
  • 03Capture emails by CCing an address to save them as notes.
  • 04Import and export contacts.
  • 05Sign in with Google, Azure, Keycloak or Auth0.
  • 06Expose an API for integration with other systems.

Use cases

  • Running a small sales team's contact and deal pipeline on your own infrastructure.
  • Building a customized CRM by forking and adapting the React components.
  • Learning how to build a React and Supabase admin application.

Quick start

  1. 1

    Fork and clone the repository

    git clone https://github.com/[username]/atomic-crm.git
  2. 2

    Install dependencies (including local Supabase)

    cd atomic-crm && make install
  3. 3

    Start the app locally, then open http://localhost:5173/

    make start

Things to know

  • Requires Make, Node 24 LTS and Docker installed locally.
  • Running locally depends on Docker for the Supabase backend.

Topics

#crm#react#supabase#typescript#shadcn-ui#kanban#self-hosted#react-admin#react-hook-form#react-query

FAQ

What is atomic-crm?
A self-hostable CRM for managing contacts, deals, tasks and notes, built with React, shadcn/ui and Supabase. Atomic CRM is a customer relationship management app that covers the everyday workflow of a sales or account team: a contact list, a Kanban board for tracking deals through a pipeline, tasks with reminders, and notes attached to contacts. It also records an activity history across interactions, and supports importing and exporting contacts.
Is atomic-crm free to use? What license does it have?
atomic-crm is open source under the MIT license. Check the license terms before using it in commercial products.
Is atomic-crm still maintained?
Actively maintained. The last commit to atomic-crm was on Oct 16, 2026.
What can I use atomic-crm for?
Running a small sales team's contact and deal pipeline on your own infrastructure. Building a customized CRM by forking and adapting the React components. Learning how to build a React and Supabase admin application.
How do I install atomic-crm?
Fork and clone the repository: git clone https://github.com/[username]/atomic-crm.git Install dependencies (including local Supabase): cd atomic-crm && make install Start the app locally, then open http://localhost:5173/: make start
Where can I get atomic-crm?
The source code and installation instructions are on GitHub: https://github.com/marmelab/atomic-crm

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects