Settings
Overview
The Settings module provides profile information management and security settings. Profile Information includes extensive editing capabilities for personal details, Ghana Card, Voter ID, phone and email verification. Security covers password change.
Navigate to: Sidebar → Settings or /settings
Settings Tabs
The Settings page is organized into two tabs:
| Tab | Description |
|---|---|
| Profile Information | Edit personal details, identity documents, contact information |
| Security | Change password, manage account security |
!!! tip "Things to check" - Tab switching works correctly and loads the appropriate content - The active tab is visually highlighted - Both tabs load without errors
Profile Information
Profile Header
| Element | Description |
|---|---|
| Avatar | Profile picture with edit option |
| Full Name | Rate payer's full name |
| Registered email address | |
| Phone | Registered phone number |
Personal Details Section
| Field | Required | Notes |
|---|---|---|
| First Name | Yes | |
| Middle Name | No | |
| Surname | Yes | |
| Date of Birth | No | Date picker |
| Gender | No | Dropdown |
Identity Documents Section
| Field | Required | Notes |
|---|---|---|
| Ghana Card Number | No | Format: GHA-XXXXXXXXX-X |
| Voter ID Number | No | |
| Identification Type | Yes | Dropdown (e.g. Ghana Card, Voter ID) |
| ID Number | Yes | Format depends on Identification Type |
Contact Information Section
| Field | Required | Notes |
|---|---|---|
| Phone Number | Yes | Country code selector (defaults +233 Ghana) + number |
| Email Address | No | |
| Phone Verified | Status indicator | Shows verified/unverified status |
| Email Verified | Status indicator | Shows verified/unverified status |
Address Section
| Field | Required | Notes |
|---|---|---|
| Full Address | Yes | |
| Digital Address | Yes | e.g. GA-123-4567 |
| Region | Yes | Dropdown |
| District / MMDA | Yes | Dropdown — dependent on selected Region |
| House / Plot Number | No | |
| Landmark | No | |
| Town / Locality | No | |
| Community / Village | No | |
| Electoral Area | No | |
| Traditional Authority | No | |
| Postal Address | No |
Save Changes
A Save Changes button at the bottom submits all profile updates.
!!! tip "Things to check"
- Required fields (First Name, Surname, Phone Number, Full Address, Digital Address, Region, District) block Save if cleared
- Ghana Card Number format is validated against the pattern GHA-XXXXXXXXX-X
- District / MMDA options correctly filter based on the selected Region
- Phone verification status updates after completing the verification flow
- Email verification status updates after completing the verification flow
- Save button is disabled while the form is being submitted (prevents double-submit)
- After saving, the updated values persist and are reflected across the application
- Identity document changes may re-trigger a verification step — confirm behavior
Phone / Email Verification
When changing the phone number or email, a verification step may be required.
Phone Verification
| Element | Description |
|---|---|
| New phone number input | Country code selector + number |
| Send OTP button | Sends a 6-digit OTP to the new number |
| OTP input | 6-digit code entry |
| Verify button | Submits the OTP |
| Resend link | Re-sends the OTP after a countdown |
Email Verification
| Element | Description |
|---|---|
| New email input | Email address field |
| Send OTP button | Sends a 6-digit OTP to the new email |
| OTP input | 6-digit code entry |
| Verify button | Submits the OTP |
| Resend link | Re-sends the OTP after a countdown |
!!! tip "Things to check" - Changing the phone number requires OTP re-verification to the new number - Changing the email requires OTP re-verification to the new email - OTP expires after a reasonable window and expired codes are rejected - Verification failure shows a clear error and allows retry - After successful verification, the new phone/email is saved and reflected across the account
Security
Change Password
| Field | Required | Notes |
|---|---|---|
| Current Password | Yes | Show/hide toggle |
| New Password | Yes | Show/hide toggle, strength meter with 4 rules: at least 8 characters, upper & lower case, at least one number, at least one symbol |
| Confirm New Password | Yes | Must match New Password |
Update Password button submits the change. A tip reminds users not to reuse passwords across sites.
!!! tip "Things to check" - An incorrect Current Password is rejected with a clear error, not a generic failure - New Password is validated against all 4 rules before Update Password is enabled - Confirm New Password flags a mismatch before submission is attempted - After a successful change, confirm whether the user is signed out (forcing re-login with the new password) or stays signed in — and that either way, the old password no longer works - Password strength meter updates live as the user types - Update Password button is disabled while the form is being submitted
Logout
A Sign Out option is available in the Settings page.
| Element | Description |
|---|---|
| Sign Out button | Clears the session and redirects to the login page |
!!! tip "Things to check" - Sign out clears all session data (tokens, user info) - After sign out, navigating to a protected route redirects to login - The old session cannot be restored by using browser back navigation - Sign out works correctly when multiple tabs are open
!!! tip "Things to check" - Profile changes persist across sessions - Both Profile Information and Security tabs load correctly - Form validation prevents submission of invalid data - All verification flows (phone, email) complete successfully - Settings page is responsive and usable on mobile viewports