# Quick Start

### Installation

Navigate to your root folder **`(i.e. mantis-material-react)`**

```
c:\>cd mantis-material-react
```

Install Packages by **npm** or **yarn** as per your preferences. Here we are using **`yarn`** a package manager.

```bash
c:\mantis-material-react> yarn
```

{% hint style="warning" %}
If you are using npm, please use **npm i**
{% endhint %}

{% hint style="info" %}
**We would recommend yarn over npm**. Why? See this: <https://www.whitesourcesoftware.com/free-developer-tools/blog/npm-vs-yarn-which-should-you-choose/>
{% endhint %}

### Start

After the package installation, you can start your app by using **`yarn start`** command

```bash
c:\mantis-material-react> yarn start
```

For NextJS use **`yarn dev`** command

```bash
c:\mantis-material-react> yarn dev
```

This will start your local server at **`http://localhost:3000`** Also, your terminal shows the following.

```javascript
Compiled successfully!

You can now view mantis-material-react in the browser.

Local:            http://localhost:3000    
On Your Network:  http://192.168.29.77:3000

Note that the development build is not optimized.
To create a production build, use yarn build.
```

### Build & Deploy

This might be too early to deploy, but it is always good to know how to deploy.

To build your app for production use **`yarn build`** command

```javascript
c:\mantis-material-react> yarn build
or
c:\mantis-material-react> npm run build
```

## Troubleshooting

1. This project uses **Yarn (via Corepack)** for dependency management. The required Yarn version is specified in the `package.json` file, and Corepack ensures the correct version is used automatically. There's no need to install Yarn globally.

**If Corepack is not available:**

Corepack is included with Node.js versions 16.10+ by default. If it's not installed or enabled:

1. Ensure you’re using Node.js 16.10 or higher.
2. Enable Corepack by running : `corepack enable`
3. If Corepack is unavailable, update Node.js to a supported version.

After Corepack is enabled, simply run `yarn` commands, and the correct version will be handled for you automatically. For more information about Yarn and Corepack, refer to the documentation:

1. [https://yarnpkg.com/getting-started/install](https://yarnpkg.com/getting-started/installhttps://yarnpkg.com/corepack)

2. [https://yarnpkg.com/corepack](https://yarnpkg.com/getting-started/installhttps://yarnpkg.com/corepack)

3. An issue in the next JS production build

<figure><img src="https://content.gitbook.com/content/vmuA4PHr0UGwcIHFy0W6/blobs/XHHdHbfk4500PcaHTuH1/Screenshot%202022-11-17%20202925.png" alt=""><figcaption><p>next js build issue</p></figcaption></figure>

**Cause:** <https://github.com/vercel/next.js/discussions/30468>

**Solution:** Install the missing software from here: <https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170>

{% hint style="info" %}
**You’ll need to have Node v12.x.x or later on your local development machine** (but it’s not required on the server). You can use [nvm](https://github.com/creationix/nvm#installation) (macOS/Linux) or [nvm-windows](https://github.com/coreybutler/nvm-windows#node-version-manager-nvm-for-windows) to easily switch Node versions between different projects.
{% endhint %}