# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://codedthemes.gitbook.io/mantis/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.