Riders: Key Features and Workflow¶
OvApp provides Riders with tools to manage battery swaps, track swap history, view charging stations, and much more. This section will walk you through the key features accessible to Riders and also cover:
- How Riders sign in or create an account
- What information is required during registration
- Rider-specific features: Keypad, Map & Routes, Swap History
- How these features behave online and offline.
Access Model¶
- Riders typically log in to OvApp so their swaps and payments can be linked to their Rider profile.
- After login, they see Rider-specific menus such as:
- Keypad
- Routes / Map
- Swap History
If a Rider is new to the system, they must first create an account from the login screen.
Rider Login Screen¶

When OvApp starts in Rider mode, the first screen is the Welcome / Login view.
Screen Elements¶
-
Language selector (top right)
- Lets the Rider choose the app language (English and French).
- Changing this affects all labels and messages in the UI.
-
Email
- The email address registered for the Rider.
- Used as the primary login identifier.
-
Password
- The password associated with the Rider’s account.
- The eye icon toggles between hiding and showing the password text for easier entry.
-
Sign In button
- Attempts to log the Rider in using the email + password.
- On success, the Rider is taken to the main OvApp home screen with access to Keypad, Routes, and Swap History.
- On failure, an error message is shown (e.g. “Invalid credentials”).
-
Create New Account button
- Opens the Rider registration form (see next section).
- Used when the Rider doesn’t yet have an account in the system.
💡 If a Rider forgets their password, the current deployment may provide a reset flow via support or another channel. Document any password reset process separately if available.
Creating a Rider Account¶

New Riders can create an account directly from the app by tapping Create New Account on the login screen. This opens the Rider Registration form.
Required Fields¶
All fields marked with a red * are mandatory.
-
Full Name *
- The Rider’s full legal name.
- Used for identification in reports and support.
-
Country *
- Dropdown selector with the list of supported countries.
- Determines:
- Which country configuration/profile applies to this Rider.
- Default settings such as currency and local phone formats (depending on backend configuration).
-
Email *
- The email address OvApp will use as the login username.
- Must be unique in the system.
- Riders will use this same email on the login screen.
-
Phone *
- Primary phone number for the Rider.
- Used for contact, support, and (depending on configuration) SMS alerts or OTP codes.
-
Street Address *
- Rider’s main street or physical address.
- Helps support and operations understand where the Rider is based.
-
City *
- City or town where the Rider mainly operates.
-
Zip *
- Postal or ZIP code for the Rider’s address.
Optional Fields / Controls¶
- Assign Battery (checkbox)
- When checked, this indicates that during account creation a battery will be assigned to the Rider.
- Typical use:
- A field agent or distributor creates the Rider’s account while physically handing over a battery.
- The assignment flow (which may follow on the next screen) links that battery to the Rider’s profile.
- Exact behavior depends on the backend configuration; if not used, this checkbox can be left unchecked.
Create Account Button¶
- Create Account
- Validates the form and submits the information to the server.
- If any required field is missing or invalid, the app shows validation messages (e.g. “Please enter your email”).
- On success:
- The Rider account is created.
- The app typically either:
- Logs the Rider in automatically, or
- Returns to the login screen with a success message so the Rider can sign in with the new credentials.
🔐 All registration data is sent over a secure connection (HTTPS) in production deployments. Backend validation ensures that duplicate emails or invalid phone numbers are rejected.
Menu Overview¶
Riders can access the following sections from the main menu:
- Dashboard – Provides an overview of the Rider's account.
- Products – Shows the available products, including battery fleets.
- Transactions – Displays past transaction history for battery swaps.
- Charging Stations – Shows a map of nearby charging stations.
- Support – Access to support tickets for any issues or queries.
Rider Dashboard¶

When the Rider logs into the app, they will be greeted with the Dashboard that displays key information about their account:
1. Welcome Message¶
- "Welcome back, [Rider Name]"
- This section greets the Rider by name and lets them know they are logged in successfully. It also includes any messages about their account status or updates.
2. Active Products¶
- Active Products: This section shows the number of active products the Rider is using. For example, if the Rider has active subscriptions like a battery fleet service or electricity refuel service, this section will display the active service count.
- Example: "Active Products: 0" (This indicates the Rider is not currently subscribed to any active products).
3. Subscribed Products¶
- Subscribed Products: Lists the products or services the Rider has subscribed to, along with relevant details for each product.
- For each subscription, the following details are shown:
- Service Name: The name of the product or service (e.g., "Kenya Electricity Refuel Service").
- Service Code: A unique code identifier for the service (e.g., "Code: 232058").
- Status: Indicates the current status of the subscription (e.g., Pending, Active).
- Next Cycle: Displays the next payment cycle or renewal date (e.g., "Next Cycle: Nov 4, 2025").
- For each subscription, the following details are shown:
Example Subscribed Products:¶
1. Kenya Electricity Refuel Service
- Code: 232058
- Status: Pending
- Next Cycle: Nov 4, 2025
2. Kenya Standard Battery Fleet
- Code: 762516
- Status: Pending
- Next Cycle: Nov 6, 2025
Key Features in the Dashboard¶
-
Active Products:
-
Shows a summary of active services the Rider has access to.
-
Riders can quickly see how many services they are using and whether any action is needed to activate or renew them.
-
Subscribed Products:
-
A detailed list of all products or services tied to the Rider’s profile.
-
Provides quick access to view the status and next payment cycle for each subscription.
-
Easy Navigation:
-
From this view, Riders can access other features like Transactions, Charging Stations, and Support.
🔧 The Dashboard dynamically updates based on the Rider’s subscription status and any recent transactions or updates to their account.
Key Features¶
1. Support Tickets¶

Riders can create, view, and manage support tickets from the Support section. The screen provides:
- My Tickets: Shows all active and past support tickets raised by the Rider.
- Search Tickets: A search bar to quickly find specific tickets by keywords.
- Ticket Priority: Shows the priority level of each ticket (e.g., Low, Medium, High).
Riders can create new support tickets by clicking on the + button in the top-right corner. The new ticket form will ask for relevant details like:
- Issue description
- Category (if available)
Each ticket will be categorized as "Medium", "Low", or "High" priority, depending on its urgency.
2. Charging Stations¶

The Charging Stations page shows a map of nearby stations, allowing Riders to find stations on their route where they can swap or recharge batteries.
Features:
- Find stations near me: Uses GPS to find and display swap stations near the Rider's location.
- Map interaction: Allows the Rider to zoom in/out and see the available stations.
Steps:¶
- Tap on Charging Stations from the main menu.
- Click Find stations near me to see nearby locations.
- Tap on any station marker for more details about the station.
3. Transactions¶

The Transactions section allows Riders to view their past transactions related to battery swaps and services.
- Transaction ID: Unique identifier for the transaction.
- Plan: Describes the type of service (e.g., Battery Swap Monthly).
- Amount: The amount charged for the service.
- Date: The date the transaction was made.
- Status: Current status of the transaction (Completed, Pending, etc.).
Riders can track their financial activities here, including what they’ve paid for and when their next payment is due.
4. Product Subscriptions¶

Riders can view and subscribe to various services provided through the app, such as:
-
Kenya Electricity Refuel Service
Provides a specific power refill for a set amount of time or capacity. -
Kenya Standard Battery Fleet
Access to a fleet of batteries available for swapping. -
Kenya Premium Battery Fleet
A higher-end option for Riders, offering premium services.
For each product, the Rider can see: - Code: A unique identifier for the product or service. - Amount: The cost of the product or service. - Subscription status: Whether the product is active or pending.
5. Offline Functionality¶
Riders can continue using OvApp offline in some areas:
- Keypad: Riders can still enter tokens or codes to activate devices even without an internet connection.
- Cached data: The Rider can view cached swap history and charging station data even without connectivity.
- Syncing: Any changes or actions made offline (e.g., entering a token) will be synced when the Rider’s phone reconnects to the internet.
Summary of Key Sections:¶
- Support Tickets: Allows Riders to manage and track issues with the app or devices.
- Charging Stations: Lets Riders find nearby swap stations using maps.
- Transactions: Keeps track of all Rider payments and battery swaps.
- Product Subscriptions: Provides access to services and their details like cost, code, and status.
- Profile Management: Allows Riders to keep their personal details up-to-date.
- Offline Functionality: Ensures Riders can use key features without connectivity.
Conclusion¶
OvApp provides Riders with a comprehensive toolkit for battery swapping, managing their transactions, locating nearby swap stations, and accessing support. Whether online or offline, OvApp ensures Riders can always manage their services and track their activities effectively.