twentyhq/twenty
1
1
Fork 0
mirror of https://github.com/twentyhq/twenty.git synced 2024-12-18 00:52:21 +03:00
Code Issues Packages Projects Releases Wiki Activity
Building a modern alternative to Salesforce, powered by the community.
268 Commits 99 Branches 67 Tags 283 MiB
TypeScript 97.5%
MDX 1.8%
JavaScript 0.3%
HCL 0.2%
Shell 0.1%
e19a85a5d0
Go to file
Anders Borch e19a85a5d0
Build fixes (#76) 
* Fix compose syntax error

It turns out that docker compose does not like a literal `true`
but it will accept a `"true"` string.

* Added missing && operators
2023-04-26 09:53:11 +02:00
.github/workflows Add linter on CI 2023-04-20 11:51:04 +02:00
docs Remove broken link in doc 2023-04-25 23:50:31 +02:00
front Setup GraphQL Code Generator (#74) 2023-04-25 17:25:30 +02:00
hasura Merge pull request #68 from twentyhq/cbo-add-user-to-workspaces-on-signup 2023-04-24 17:01:24 +02:00
infra Build fixes (#76) 2023-04-26 09:53:11 +02:00
server Fix server build 2023-04-24 18:04:55 +02:00
.gitignore chore: change way to store npm secrets 2023-04-18 15:31:58 +02:00
.prettierignore Setup GraphQL Code Generator (#74) 2023-04-25 17:25:30 +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 Store refresh token on login 2023-04-21 09:33:57 +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 and npmrc variables

  1. cp ./infra/dev/.env.example ./infra/dev/.env and fill with values
  2. cp ./front/.npmrc.example ./front/.npmrc 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
make up

Once this is completed you should have:

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