100 lines
2.1 KiB
Markdown
100 lines
2.1 KiB
Markdown
|
## Getting Started
|
|||
|
|
|
|||
|
|
Follow these steps to set up and run the project locally.
|
|||
|
|
|
|||
|
|
### Prerequisites
|
|||
|
|
|
|||
|
|
Ensure you have the following installed on your system:
|
|||
|
|
|
|||
|
|
- **Node.js**: [Download and install Node.js](https://nodejs.org/)
|
|||
|
|
- **npm**: Comes with Node.js, but you can also install [npm separately](https://www.npmjs.com/get-npm)
|
|||
|
|
- **yarn (optional)**: If you prefer to use Yarn, [install it here](https://yarnpkg.com/)
|
|||
|
|
- **TypeScript**: This project uses TypeScript, and the necessary dependencies will be installed automatically.
|
|||
|
|
|
|||
|
|
### Installation
|
|||
|
|
|
|||
|
|
1. Clone the repository:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/S0Vishnu/react-production-project-boilerplate.git
|
|||
|
|
cd react-production-project-boilerplate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. Cloning repository with User Credentials:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://your_username:password@github.com/S0Vishnu/react-production-project-boilerplate.git
|
|||
|
|
cd react-production-project-boilerplate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
note: if password contains special charecters use:
|
|||
|
|
|
|||
|
|
- @ → %40
|
|||
|
|
- : → %3A
|
|||
|
|
- / → %2F
|
|||
|
|
- ? → %3F
|
|||
|
|
- & → %26
|
|||
|
|
- = → %3D
|
|||
|
|
- ! → %21
|
|||
|
|
|
|||
|
|
2. Install the dependencies:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. Start server:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm start
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. Build the app for production:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
5. Tests
|
|||
|
|
|
|||
|
|
This project includes both **unit tests** using **Jest** and **end-to-end (E2E) tests** using **Cypress**. Here’s how you can run and manage these tests.
|
|||
|
|
|
|||
|
|
**Unit Tests (Jest)**
|
|||
|
|
Unit tests are located in the `src/tests/unit/` directory. They test individual components and functions to ensure they work as expected. **Jest** is used for running these tests.
|
|||
|
|
|
|||
|
|
**Running Unit Tests**
|
|||
|
|
To run the unit tests, use the following command:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run test
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**End-to-End (E2E) Tests (Cypress)**
|
|||
|
|
Cypress can be run in two modes
|
|||
|
|
|
|||
|
|
1. Interactive Mode:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run cypress:open
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. Headless Mode:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run cypress:run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Run Documentation(Docsify)
|
|||
|
|
|
|||
|
|
1. Installation (if needed):
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm i docsify-cli -g
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. Run Command:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
docsify serve docs
|
|||
|
|
```
|