twenty/README.md

<br>
<p align="center">
  <a href="https://www.twenty.com">
    <img src="./docs/static/img/logo-square-dark.svg" width="100px" alt="Twenty logo" />
  </a>
</p>

<h2 align="center" >A Modern Open Source CRM </h3>
<p align="center">Crafted with Engineer-Precision. Built for Business-Success.</p>

<p align="center"><a href="https://twenty.com">Website</a> · <a href="https://docs.twenty.com">Documentation</a> · <a href="https://twenty.com/story">Story</a> · <a href="https://discord.gg/cx5n4Jzs57">Discord</a></p>
<br />

<p align="center">
  <a href="https://www.twenty.com">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/preview-dark.png">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/preview-light.png">
      <img src="./docs/static/img/preview-light.png" alt="Companies view" />
    </picture>
  </a>
</p>

# Quickstart
You can access and use the alpha version on [app.twenty.com](https://app.twenty.com).  
Soon, we will release click-to-deploy buttons for Render and Railway.

For a local setup, please check [the documentation](https://docs.twenty.com/developer/local-setup).  
It's a straightforward process that should have you up and running in minutes.

# About
We are building an Open Source CRM designed to be: enjoyable to use, easily extendable, and perfectly in-sync with your data. 

Twenty was created as a Public Benefits Company. This means we're legally bound to consider the impact of our decisions not just on shareholders, but also on society.
Our belief is simple: great companies focus on helping people and meeting their users' needs above all. The decision to go open source was therefore a natural one for us. It fits with our aim to do what's right and with our goals for the business:

**For our users:**
- A commitment to being completely open about what we're building, enabling them to peek under the hood and see the intricate machinery at work.
- An opportunity to be a decisive actor with a very short feedback loop and an the ability to shape the roadmap
  
**For the developer community:**
- A CRM that ban self-hosted for free, on your own network and close to your data sources
- A set of reusuable components such as tables or kanban boards (coming soon)
- A new way to think about CRM extensibility, one that can be owned by the engineering team and not external constultants (coming soon)


# Features
We are currently in the development phase of Twenty's alpha version.  
Don't hesitate to flag a specific need by creating an issue.   

Below are the features we have implemented to date.

You can add, filter, sort, edit and track your customers:

<p align="center">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/visualise-customer-dark.png">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/visualise-customer-light.png">
      <img src="./docs/static/img/preview-light.png" alt="Companies view" />
    </picture>
</p>

You can create one or several opportunities for each company:

<p align="center">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/follow-your-deals-dark.png">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/follow-your-deals-light.png">
      <img src="./docs/static/img/preview-light.png" alt="Companies view" />
    </picture>
</p>

You can create rich notes (and soon tasks) that are displayed in a timeline:

<p align="center">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/rich-notes-dark.png">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/rich-notes-light.png">
      <img src="./docs/static/img/preview-light.png" alt="Companies view" />
    </picture>
</p>

You can navigate quickly through the app using keyboard shortcuts and search:

<p align="center">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/shortcut-navigation-dark.png">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/twentyhq/twenty/main/docs/static/img/shortcut-navigation-light.png">
      <img src="./docs/static/img/preview-light.png" alt="Companies view" />
    </picture>
</p>

# Upcoming features

Coming before August 15:  
⚙️  A task system<br>
⚙️  A notification center<br>
⚙️  More standard fields<br>
⚙️  AI/LLM integration to Notes<br>
⚙️  Pipelines and table customization<br>
⚙️  A new dark mode with higher contrasts<br>
⚙️  A lot of bug fixes and other improvements<br>

Coming later this year:  
📅  Advanced search and filters<br>
📅  Auto-logging emails<br>
📅  Data connectors<br>
📅  Custom fields<br>
📅  Custom objects<br>
📅  +++<br>

Track planning on [Github Projects](https://github.com/orgs/twentyhq/projects/1) and help us prioritising by upvoting or creating [issues](https://github.com/twentyhq/twenty/issues)

# Documentation
The doc is available on [docs.twenty.com](https://docs.twenty.com).

If you have any question feel free to ask on our [Discord](https://discord.gg/cx5n4Jzs57).

# Helping us
- The easiest way to help us is to star the repo and helping us getting visibility.
- Contributions are, of course, most welcome!  
It doesn't have to be code, you could create an [issue](https://github.com/twentyhq/twenty/issues) to report a bug you've spotted, join [discussions](https://github.com/twentyhq/twenty/discussions), [Discord](https://discord.gg/cx5n4Jzs57) or write [documentation](https://docs.twenty.com/).


# Office hours
Want to meet the team? Get direct support?
Feel free to book a slot during our office hours.

<a href="https://cal.com/team/twenty?utm_source=banner&utm_campaign=oss">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://cal.com/book-with-cal-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://cal.com/book-with-cal-light.svg">
    <img alt="Book us with Cal.com" src="https://cal.com/book-with-cal-light.svg" height="40">
  </picture>
</a>