2025-11-11 13:49:46 +00:00
|
|
|
|
# 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
|
2025-08-13 14:23:48 +01:00
|
|
|
|
```
|
2025-11-11 13:49:46 +00:00
|
|
|
|
### Running Locally
|
|
|
|
|
|
```bash
|
|
|
|
|
|
yarn dev
|
|
|
|
|
|
```
|
|
|
|
|
|
The app will be available at `http://localhost:5173`.
|
|
|
|
|
|
|
2025-08-13 14:23:48 +01:00
|
|
|
|
|
2025-11-11 13:49:46 +00:00
|
|
|
|
To run on locally on other devices
|
|
|
|
|
|
```bash
|
|
|
|
|
|
yarn dev --host
|
2025-08-13 14:23:48 +01:00
|
|
|
|
```
|
2025-11-11 13:49:46 +00:00
|
|
|
|
The app will be available at the exposed addresses to access e.g. http://192.168.0.123:5173/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://100.118.196.113:8080
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 🧪 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
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
