Skip to main content

Overview

The Settings page allows all users (both admin and regular users) to manage their personal information, change passwords, and configure notification preferences. All users have access to their own settings.
You can only edit your own settings. Administrators can modify other users’ information through the User Management page.

Accessing Settings

To access your settings:
  1. Log in to the Transport Logistics platform
  2. Click on your profile or navigate to Settings from the main menu
  3. The Settings page opens with three tabs: Profile, Security, and Notifications

Profile Settings

Managing Your Profile

The Profile tab contains your personal information and account details:
Avatar Management:
  • Your avatar displays your username’s first letter by default
  • Click Change Avatar to upload a custom profile picture (future feature)
  • Avatar appears throughout the application

Updating Your Profile

1

Navigate to Profile Tab

Open Settings and ensure the Profile tab is selected.
2

Edit Information

Modify any of the editable fields:
  • Username
  • Full Name
  • Phone Number
3

Save Changes

Click the Save Changes button at the bottom of the form.
4

Confirmation

You’ll see a success message when your profile is updated.
Email addresses cannot be changed once an account is created. This is a security measure to prevent unauthorized account access.

Profile Form Fields

interface ProfileForm {
  username: string;    // Display name (required)
  email: string;       // Email (read-only)
  fullName: string;    // Full name (optional)
  phoneNumber: string; // Phone number (optional)
}

Security Settings

Changing Your Password

Regularly updating your password helps keep your account secure:
1

Navigate to Security Tab

Click on the Security tab in the Settings page.
2

Enter Current Password

Provide your current password for verification.
3

Enter New Password

Type your new password in the “New Password” field.
Password must be at least 6 characters long.
4

Confirm New Password

Re-enter your new password in the “Confirm New Password” field.
5

Update Password

Click Update Password to save your new password.

Password Requirements

Your password should meet the following criteria:

Length

At least 8 characters long (minimum 6 enforced)

Uppercase

At least one uppercase letter (recommended)

Number

At least one number (recommended)

Special Character

At least one special character (recommended)
Strong passwords combine uppercase and lowercase letters, numbers, and special characters. Consider using a password manager.

Password Change Process

The system validates passwords before updating:
if (newPassword !== confirmPassword) {
  throw new Error("New passwords do not match");
}

if (newPassword.length < 6) {
  throw new Error("Password must be at least 6 characters");
}

// Update through Supabase Auth
await supabase.auth.updateUser({
  password: newPassword,
});

Notification Preferences

Managing Notifications

Control how and when you receive notifications about system activities:
Choose how to receive notifications:Email Notifications
  • Receive notifications via email
  • Ideal for important updates
  • Toggle on/off as needed
SMS Notifications
  • Receive notifications via SMS
  • Great for urgent updates
  • Requires phone number in profile

Notification Settings Configuration

1

Open Notifications Tab

Click on the Notifications tab in Settings.
2

Configure Channels

Toggle Email and SMS notifications on or off based on your preferences.
3

Select Notification Types

Enable or disable specific notification types:
  • Shipment Updates
  • System Announcements
4

Save Preferences

Click Save Preferences to update your notification settings.

Notification Settings Structure

interface NotificationSettings {
  emailNotifications: boolean;   // Enable email notifications
  smsNotifications: boolean;     // Enable SMS notifications
  shipmentUpdates: boolean;      // Receive shipment updates
  systemAnnouncements: boolean;  // Receive system announcements
}

Database Storage

Notification preferences are stored in the user_settings table:
CREATE TABLE user_settings (
  user_id UUID PRIMARY KEY REFERENCES auth.users(id),
  email_notifications BOOLEAN DEFAULT true,
  sms_notifications BOOLEAN DEFAULT false,
  shipment_updates BOOLEAN DEFAULT true,
  system_announcements BOOLEAN DEFAULT true,
  updated_at TIMESTAMP DEFAULT NOW()
);

For Administrators

  • Use a professional username
  • Add full name for easy identification
  • Include a phone number for urgent contact
  • Use a strong, unique password
  • Change password every 90 days
  • Never share your admin credentials
  • Enable both email and SMS for critical updates
  • Keep shipment updates enabled
  • Enable system announcements for maintenance alerts

For Regular Users

  • Keep username updated and professional
  • Add contact information for collaboration
  • Review your assigned packages regularly
  • Change default password on first login
  • Use a password manager for strong passwords
  • Update password if you suspect compromise
  • Enable email notifications for important updates
  • Enable SMS only if you need real-time alerts
  • Customize based on your workflow needs

Best Practices

Keep Information Current

Regularly update your profile information, especially if your contact details change.

Use Strong Passwords

Create unique, complex passwords and change them periodically.

Configure Notifications

Set up notifications based on your role and responsibilities to avoid notification fatigue.

Review Settings Regularly

Periodically review your settings to ensure they still meet your needs.

Common Workflows

First-Time Login Setup

1

Log In

Use the credentials provided by your administrator.
2

Update Password

Navigate to Settings > Security and change your password immediately.
3

Complete Profile

Go to Settings > Profile and add your full name and phone number.
4

Set Notifications

Configure your notification preferences in Settings > Notifications.

Updating Contact Information

1

Open Profile Settings

Navigate to Settings > Profile tab.
2

Update Fields

Modify your username, full name, or phone number as needed.
3

Save Changes

Click Save Changes to update your profile.
4

Verify Update

Check that your changes are reflected in your profile.

Resetting Your Password

1

Navigate to Security

Go to Settings > Security tab.
2

Enter Passwords

Provide your current password and enter your new password twice.
3

Validate Password

Ensure your new password meets the requirements.
4

Update

Click Update Password and wait for confirmation.
5

Test New Password

Log out and log back in with your new password to verify it works.

Troubleshooting

Check the following:
  • Ensure you have an active internet connection
  • Verify all required fields are filled
  • Try refreshing the page and trying again
  • Check browser console for error messages
Common issues:
  • New passwords don’t match
  • Current password is incorrect
  • New password is too short (minimum 6 characters)
  • Special characters may cause issues in some cases
Solution: Try a simpler password without special characters, then strengthen it later.
Troubleshooting steps:
  • Verify notification settings are enabled
  • Check your email spam/junk folder
  • Confirm your email address is correct
  • For SMS, ensure your phone number is added to your profile
  • Wait 5-10 minutes for settings to propagate
This is expected behavior. Email addresses cannot be modified for security and audit purposes. If you need to change your email:
  • Contact an administrator
  • They can create a new account with the correct email
  • Your data can be transferred to the new account
Try these steps:
  • Check that you clicked the Save button
  • Wait for the success message
  • Refresh the page to verify changes persisted
  • Clear browser cache if changes aren’t visible
  • Try a different browser

Security Tips

Never share your password with anyone, including administrators. Legitimate administrators will never ask for your password.

Use Unique Passwords

Don’t reuse passwords from other websites or applications.

Enable Two-Factor

When available, enable two-factor authentication for additional security.

Log Out When Done

Always log out, especially on shared or public computers.

Report Suspicious Activity

Contact an administrator immediately if you notice unusual account activity.

Managing Users

Admin guide for managing user accounts (admin only)

Roles & Permissions

Understand what your role can access and do

Build docs developers (and LLMs) love