Vehicle Management
Complete vehicle lifecycle management including creation, bulk upload, device linking, configuration, sensors, documents, and user assignment.
Last updated April 17, 2026
Vehicle Management Overview
The Vehicles module (title: "Vehicles", subtitle: "View and manage your vehicles.") is the central hub for fleet vehicle administration. It provides full CRUD operations, bulk import, device and plan linking, and detailed per-vehicle configuration.
Vehicle Table
| Column | Description |
|---|---|
| Vehicle | Vehicle identifier with icon |
| Name | Assigned vehicle name |
| Type | Vehicle type from master data (Car, Truck, Bike, etc.) |
| IMEI | Linked device IMEI number |
| SIM | SIM card number (auto-populated from linked device) |
| Status | Active or Inactive |
| Plate | License plate number |
| VIN | Vehicle Identification Number |
| Primary User | Assigned primary user |
| Added | Creation date timestamp |
Filters & Actions
- Status filter — Active or Inactive
- Type filter — filter by vehicle type
- Free-text search — search across vehicle name, IMEI, plate, VIN
| Action | Description |
|---|---|
| Add Vehicle | Opens the Add Vehicle modal form |
| Bulk Upload | Launches the bulk CSV import wizard |
| Assign to User | Tooltip action to assign selected vehicles to a user |
| Delete Selected | Tooltip action to delete selected vehicles with confirmation |
| Toggle Status | Switch vehicle between Active and Inactive |
Add Vehicle Modal
Title: "Add Vehicle". Subtitle describes entering vehicle details for fleet registration.
| Field | Type | Validation | Notes |
|---|---|---|---|
| Primary User | Search/Select | Required (selectUser) | Searchable dropdown with + Add New User quick-create |
| Vehicle Name | Text | Required, min 2 chars (nameMin) | Placeholder text provided |
| Plate No. | Text | Required, min 2 chars (plateMin) | License plate placeholder |
| VIN | Text | Required, min 10 chars (vinMin) | Vehicle Identification Number |
| Vehicle Type | Select | Required (selectVehicleType) | From master data vehicle types |
| Device IMEI | Search | Required (selectDevice) | Search by IMEI with + Add New Device quick-create |
| Plan | Select | Required (selectPlan) | From plans list with + Add New Plan quick-create |
| SIM | Auto | — | Auto-populated from linked device |
| Days | Display | — | Shows plan duration days count |
Vehicle Detail Tabs
- Profile — map view with Center Map, Follow/Following toggle, Show/Hide Path, trail loading animation, and waiting for GPS state. Shows status badge, Set Active/Set Inactive toggle, last update time, speed, ignition state, and device connection status.
- Details — vehicle information fields (read/edit)
- Config — device configuration parameters
- Events — vehicle event log (coming soon)
- Sensors — computed sensor management (see Sensors page)
- Documents — file uploads with metadata
- Users — user assignment and linking
- Logs — activity and telemetry logs for this vehicle
- Send Commands — command dispatch to linked device
Config Tab
| Setting | Description | Helper Text |
|---|---|---|
| Speed Multiplier (speedX) | Multiplier applied to raw speed values from the device | Adjusts speed readings; default 1.0 |
| Distance Multiplier (distanceX) | Multiplier applied to raw distance calculations | Adjusts distance readings; default 1.0 |
| Set Odometer (km) | Override the cumulative odometer value | Enter value in kilometers |
| Set Engine Hours (hours) | Override the cumulative engine hours | Enter value in hours |
| Ignition Source | How ignition state is determined | Options: Ignition Wire (hardware) or Motion Based (software via speed threshold) |
Documents Tab
- Click Add Document to upload a new file
- Enter document title (required) and optional description
- Select document type from master data (Vehicle/Driver/User categories)
- Set optional expiry date for time-sensitive documents
- Add optional tags for categorization
- Toggle 'Visible to Admin' flag to control admin visibility
- Supported formats: PDF, Images (PNG, JPEG), DOC/DOCX
- Edit or Delete existing documents via action buttons
Users Tab
The Users tab shows a USERS section label with the linked count. Features include: search users, assign user button, associated users list, and link/unlink actions for each user.
Bulk Upload
Bulk upload starts by selecting a Device Type. If no vehicle types exist, a title and message are displayed. A "Go back" link returns to the vehicle list. The upload follows a multi-step wizard process.
Assignment Modal
The Assign Modal shows a title, the count of selected vehicles, a loading state while fetching users, a searchable user dropdown, and handles the 'no users available' state gracefully.
Delete Confirmations
- Single delete — confirmation dialog for one vehicle
- Bulk delete — confirmation dialog showing the count of selected vehicles
Export
Exported files include the brand name, address lines, and a footer note: "Confidential - For Internal Use Only".
Toast Messages
| Event | Message |
|---|---|
| Created | Vehicle created successfully |
| Updated | Vehicle updated successfully |
| Deleted | Vehicle deleted successfully |
| Status Updated | Vehicle status updated |
| Failed | Operation failed — see error details |
| Assigned | X vehicles assigned to user |
| User Created | User created successfully (via quick-create) |
| Plan Created | Plan created successfully (via quick-create) |