Mav-Mobile-UI/README.md

# Mav Mobile Ui

This is a React-based web application built with Vite (react and typescript).

## Getting started

### Prerequisites

- Node.js (v18 or higher recommended)
- Yarn (v1.22+) (https://yarnpkg.com/)

### Installation

```bash
git clone https://mavportal.com/TobaOjo/Mav-Mobile-UI.git
cd Mav-Mobile-UI
yarn install
```

### Running Locally

```bash
yarn dev
```

The app will be available at `http://localhost:5173`.

To run on locally on other devices

```bash
yarn dev --host
```

The app will be available at the exposed addresses to access e.g. http://1xx.xxx.x.xxx:<PORT>/Mobile

## Tech Stack

- **React** – UI library
- **Vite** – Build tool
- **Yarn** – Package manager

## Configuration

Create a `.env` file to access the Mav Mobile box in unit 5 for or for any environment-specific settings:

```env
VITE_AGX_BOX_URL=http://1xx.xxx.xxx.xxx:<PORT>
```

## Development

### Linting & Formatting

```bash
yarn lint
yarn format
```

### Testing

(Currently not implemented – consider adding Jest or Vitest)

## Deployment

To build for production:

```bash
yarn build
```

Navigate to your Mav-Mobile-UI folder
Select the Dist folder
Compress to (ZIP)
Log into box on Moba using Session > SSH and putting IP in Remote Host.
Creds are mav:mav
Drag and drop dist.zip into file explorer menu on left hand side (has to be named dist.zip exactly).
Run command

```bash
sudo ./integrate-web-ui.sh
```

Run

```bash
sudo nano web-static/index.html
```