Skip to content

Commit

Permalink
Improve docs (twentyhq#5492)
Browse files Browse the repository at this point in the history
Fix twentyhq#4382 and remove useless pages to make docs more readable
  • Loading branch information
FelixMalfait committed May 21, 2024
1 parent a981344 commit 4907ae5
Show file tree
Hide file tree
Showing 10 changed files with 228 additions and 337 deletions.
2 changes: 1 addition & 1 deletion packages/twenty-docs/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import ThemedImage from '@theme/ThemedImage';


Twenty is a CRM designed to fit your unique business needs.
It was brought to life by a passionate community that cares about quality and precision in engineering.
It is maintained by a community of 200+ developers that care about building high-quality software.

There are three different ways to get started:
- **Managed Cloud:** The fastest and easiest way to try the app
Expand Down
226 changes: 226 additions & 0 deletions packages/twenty-docs/docs/start/local-setup.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,226 @@
---
title: Local Setup
sidebar_position: 2
sidebar_custom_props:
icon: TbDeviceDesktop
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';


Follow this guide if you would like to setup the project locally to contribute.

## Prerequisites

<Tabs>
<TabItem value="yarn" label="Linux and MacOS" default>

Before you can install and use Twenty, make sure you install the following on your computer:
- [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- [Node v18](https://nodejs.org/en/download)
- [yarn v4](https://yarnpkg.com/getting-started/install)
- [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)

:::info Note
`npm` won't work, you should use `yarn` instead. Yarn is now shipped with Node.js, so you don't need to install it separately.
You only have to run `corepack enable` to enable Yarn if you haven't done it yet.
:::

</TabItem>

<TabItem value="wsl" label="Windows (WSL)" >

1. Install WSL
Open PowerShell as Administrator and run:

```powershell
wsl --install
```
You should now see a prompt to restart your computer. If not, restart it manually.

Upon restart, a powershell window will open and install Ubuntu. This may take up some time.
You'll see a prompt to create a username and password for your Ubuntu installation.

2. Install and configure git

```bash
sudo apt-get install git
git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"
```

3. Install Node.js, nvm, yarn
```bash
sudo apt-get install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
corepack enable
```
Close and reopen your terminal to start using nvm.

</TabItem>
</Tabs>

---

## Step 1: Git Clone

In your terminal, run the following command.


<Tabs>
<TabItem value="ssh" label="SSH (Recommended)" default>
If you haven't already set up SSH keys, you can learn how to do so [here](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
```bash
git clone git@github.com:twentyhq/twenty.git
```
</TabItem>
<TabItem value="https" label="HTTPS" >

```bash
git clone https://github.com/twentyhq/twenty.git
```

</TabItem>
</Tabs>

## Step 2: Position yourself at the root

```bash
cd twenty
```

You should run all commands in the following steps from the root of the project.

## Step 3: Set up a PostgreSQL Database
We rely on [pg_graphql](https://github.com/supabase/pg_graphql) and recommend you use the scripts below to provision a database with the right extensions.
You can access the database at [localhost:5432](localhost:5432), with user `twenty` and password `twenty` .

<Tabs>
<TabItem value="linux" label="Linux" default>
<b>Option 1:</b> To provision your database locally:
```bash
make postgres-on-linux
```

<b>Option 2:</b> If you have docker installed:
```bash
make postgres-on-docker
```
</TabItem>
<TabItem value="mac-os" label="Mac OS" default>
<b>Option 1:</b> To provision your database locally with `brew`:
```bash
make postgres-on-macos-intel #for intel architecture
make postgres-on-macos-arm #for M1/M2/M3 architecture
```

<b>Option 2:</b> If you have docker installed:
```bash
make postgres-on-docker
```
</TabItem>
<TabItem value="wsl" label="Windows (WSL)">
<b>Option 1 :</b> To provision your database locally:
```bash
make postgres-on-linux
```

Note: you might need to run `sudo apt-get install build-essential` before running the above command if you don't have the build tools installed.

<b>Option 2:</b> If you have docker installed:
Running Docker on WSL adds an extra layer of complexity.
Only use this option if you are comfortable with the extra steps involved, including turning on [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl).
```bash
make postgres-on-docker
```
</TabItem>
</Tabs>


## Step 4: Setup environment variables

Use environment variables or `.env` files to configure your project.

Copy the `.env.example` files in `/front` and `/server`:
```bash
cp ./packages/twenty-front/.env.example ./packages/twenty-front/.env
cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env
```

## Step 5: Installing dependencies

:::info

Use `nvm` to install the correct `node` version. The `.nvmrc` ensures all contributors use the same version.

:::

To build Twenty server and seed some data into your database, run the following commands:
```bash
nvm install # installs recommended node version
nvm use # use recommended node version

yarn
```

## Step 6: Running the project

Setup your database with the following command:
```bash
npx nx database:reset twenty-server
```

Start the server and the frontend:
```bash
npx nx start twenty-server
npx nx start twenty-front
```

Alternatively, you can start both applications at once:
```bash
npx nx start
```

Twenty's server will be up and running at [http://localhost:3000/graphql](http://localhost:3000/graphql).
Twenty's frontend will be running at [http://localhost:3001](http://localhost:3001). Just login using the seeded demo account: `tim@apple.dev` (password: `Applecar2025`) to start using Twenty.


## Troubleshooting

#### CR line breaks found [Windows]

This is due to the line break characters of Windows and the git configuration. Try running:

```
git config --global core.autocrlf false
```

Then delete the repository and clone it again.

#### Missing metadata schema

During Twenty installation, you need to provision your postgres database with the right schemas, extensions, and users.
If you're successful in running this provisioning, you should have `default` and `metadata` schemas in your database.
If you don't, make sure you don't have more than one postgres instance running on your computer.

#### Cannot find module 'twenty-emails' or its corresponding type declarations.

You have to build the package `twenty-emails` before running the initialization of the database with `npx nx run twenty-emails:build`

#### Missing twenty-x package

Make sure to run yarn in the root directory and then run `npx nx server:dev twenty-server`. If this still doesn't work try building the missing package manually.

#### Lint on Save not working

This should work out of the box with the eslint extension installed. If this doens't work try adding this to your vscode setting (on the dev container scope):

```
"editor.codeActionsOnSave": {
"source.fixAll.eslint": "explicit"
}
```

#### Docker container build

To successfully build Docker images, ensure that your system has a minimum of 2GB of memory available. For users of Docker Desktop, please verify that you've allocated sufficient resources to Docker within the application's settings.
9 changes: 0 additions & 9 deletions packages/twenty-docs/docs/start/local-setup/_category_.json

This file was deleted.

39 changes: 0 additions & 39 deletions packages/twenty-docs/docs/start/local-setup/ide-setup.mdx

This file was deleted.

37 changes: 0 additions & 37 deletions packages/twenty-docs/docs/start/local-setup/local-setup.mdx

This file was deleted.

45 changes: 0 additions & 45 deletions packages/twenty-docs/docs/start/local-setup/troubleshooting.mdx

This file was deleted.

Loading

0 comments on commit 4907ae5

Please sign in to comment.