@zohodesk/client_build_tool/helpDocs/troubleshootings/NewMachineSetup.md

A CLI tool to build web applications and client libraries

# dev setup requirements:-

First we need to install node 12 - 16 and npm 6

if npm version 7 or greater then please check for "#Make a directory for global installations" below then install
"npm install -g npm@6"

### Find the path to npm's directory:

> npm config get prefix

For many systems, this will be `/usr/local` if it's not same then you can skip "#Make a directory for global installations"

## Make a directory for global installations:

in mac and unbundu when you install any package global you will be ask for sudo permission. if you follow the below step you do not have to use sudo for every install.

> mkdir ~/.npm-global

Configure npm to use the new directory path:

> npm config set prefix '~/.npm-global'

Open or create a `vim ~/.profile` (for unbuntu `vim ~/.bashrc`) file and add this line to bottom of that file:

```
export PATH=~/.npm-global/bin:$PATH
```

Back on the command line, update your system variables:
For mac

> source ~/.profile
> For unbuntu
> source ~/.bashrc

then open new terminal you or good to go. now you can install npm globally with out sudo

# set local registry

in order to install local packages you need to set local registry

> npm config edit

One editor will open add below line bottom of that file

```
@zoho:registry=http://cm-npmregistry.csez.zohocorpin.com
@zohocharts:registry=http://cm-npmregistry.csez.zohocorpin.com
@zohodesk-private:registry=http://cm-npmregistry.csez.zohocorpin.com
```

# for install react-cli

> npm i -g @zohodesk/react-cli

# Memory Issue

For some projects when you run app start command some memeory issue will come.SO it would be better if you do below steps you have memory issue or not if you do this memory issue would not come.

Open or create a `vim ~/.profile` (for unbuntu `vim ~/.bashrc`) file and add this line to bottom of that file:

```
export NODE_OPTIONS=--max-old-space-size=14096
```

# extra tips:-

for some git project clone may be file name too long error may come.
solution was in the below link
https://stackoverflow.com/questions/22575662/filename-too-long-in-git-for-windows