Skip to main content
Fleet Mobile is a React Native / Expo application that gives field technicians access to their assigned vehicle and inspection workflow directly from their phone. Administrators who log in on mobile are redirected to a separate management dashboard.

Running the app

1

Install dependencies

From the repository root, install all workspace packages:
yarn install
2

Start the Expo dev server

yarn workspace mobile start
The terminal will display a QR code once the bundler is ready.
3

Open on your device

Install Expo Go on your iOS or Android device, then scan the QR code with the Expo Go app (Android) or the system camera (iOS).
The app reads EXPO_PUBLIC_API_URL for the backend address. If the variable is not set, it defaults to http://localhost:3001/api. The current API base URL is shown at the bottom of the login screen for reference.

Logging in

On the login screen, enter your email address and password, then tap Entrar.

Technician demo

Email: tech@fleet.localPassword: changeme123

Admin demo

Email: admin@fleet.localPassword: changeme123
If the credentials are wrong or the server is unreachable, an error message appears below the Entrar button.

Role-based navigation

After a successful login, the app checks the role field on the authenticated user and routes accordingly.
RoleDestination
technicianAssigned Vehicle screen
adminTechnician Management dashboard
You cannot manually switch between the two flows — the routing is determined entirely by the role assigned to your account.

Main screens for technicians

Assigned Vehicle

Displays your currently assigned vehicle, license plate, and assignment status. Also shows the maintenance summary and provides a button to start an inspection.

Inspection

The vehicle inspection form where you record mileage, damage notes, the next maintenance date, and four required photos.
Tap Crear inspeccion on the Assigned Vehicle screen to navigate to the Inspection screen. Tap Volver on the Inspection screen to return to your vehicle summary.

Admin mobile dashboard

When an admin logs in on mobile, the app shows the Technician Management dashboard instead of the vehicle flow. From this screen, admins can:
  • View a summary of fleets, vehicles, assignments, and inspections
  • Manage employees (technicians), fleets, vehicles, and maintenance types
  • Create and update vehicle assignments
  • Register mandatory maintenance completions
Admins can also complete mandatory maintenance directly from the mobile dashboard without needing to go through a technician account.

Build docs developers (and LLMs) love