mirror of https://github.com/twentyhq/twenty.git synced 2024-11-26 04:17:15 +03:00

Building a modern alternative to Salesforce, powered by the community.

crm crm-system customer good-first-issue graphql javacript marketing monorepo nestjs open-source postgresql react reactjs sales starred-repo starred-twentyhq-repo typescript web

Go to file

Sammy Teillet 3e09dab7fc test: add checkbox test		2023-04-18 18:27:54 +02:00
.github/workflows	Migrate to FontAwesome pro	2023-04-14 12:09:17 +02:00
front	test: add checkbox test	2023-04-18 18:27:54 +02:00
hasura	Setup first hasura schema	2023-04-14 08:38:35 +02:00
infra	bugfix: sync server files in server container	2023-04-18 15:23:47 +02:00
server	feat: use healthz	2023-04-14 17:03:18 +02:00
.gitignore	Setup Hasura locally	2023-04-12 15:54:16 +02:00
LICENSE	Create LICENSE	2023-04-11 13:55:45 +02:00
package.json	Setup Hasura locally	2023-04-12 15:54:16 +02:00
README.md	Setup first hasura schema	2023-04-14 08:38:35 +02:00

README.md

Twenty

Welcome to Twenty documentation!

High Level Overview

Twenty development stack is composed of 3 different layers

front: our frontend React app
hasura: our graphql engine exposing our database and server
server: our backend that contain endpoint, crm logic, scripts, jobs...
storages: postgres

Setup env variables

cp ./infra/dev/.front.env.example ./front/.env and fill with values

Development environment setup with docker-compose (Recommended)

We also provide a containerized environment with Docker and orchestrated with docker-compose in case it is easier for you. This install will also provision a postgres container out of the box.

Step 1: pre-requesites

Make sure to have the latest Docker and Docker-compose versions installed on your computer. You can run docker-compose --version to check if you have docker-compose installed and docker --version to check if you have docker installed.

Step 2: docker build

Build docker containers.

The whole setup experience is happening in infra/dev folder. Make sure to be in this folder:

cd infra/dev

make build

Once this is completed you should have:

front available on: http://localhost:3001
hasura available on: http://localhost:8080
server available on: http://localhost:3000/health
postgres: available on http://localhost:5432 that should contain twenty database

Step 3: IDE setup

If you are using VSCode, please use the Dev Containers extension to open the project in a container. This will allow you to run Visual Studio on top of the docker container. This will allow you to run the project without having to install node on your machine.

Note

If you are using Docker install, make sure to ssh in the docker container during development to execute commands. You can also use Makefile to help you

Development workflow

Front tests

Run tests: make front-test Run coverage: make front-coverage Run storybook: make front-storybook

Hasura development

Open hasura console: make hasura-console Do your changes in hasura console on http://localhost:9695 Commit your changes in git