Google Sign-In Required

Use your company Google account to access the BetterFleet private content.

Back to private home

BetterFleet Support Private
Skip to content
BetterFleet Dev Wiki
bf-manage-web
Initializing search
    bf-dev
    • Home
    • Product Capabilities
    • Process
    • Current Work
    • System Design
    • Software Reference
    • Operations
    bf-dev
    • Home
      • Overview
      • Manage
      • Overview
      • Product Engineering Workflow
      • Product Engineering Delivery
      • Product Engineering Workflow in Linear
        • GitLab Feature Flags
        • In-App Docs Authoring
        • Release Notes
      • Templates
      • Publishing
      • Workflow Companions
      • Overview
      • Active Artifacts
      • Backlog Artifacts
      • Archived Artifacts
      • Overview
      • Microgrid
      • OSCP
        • Challenge
        • Specification
        • Spec
        • Architecture
        • Overview
        • Script Runtime Model
        • Compose Profiles and Modes
        • Repo Topology
        • CI and Release Integration
        • Overview
        • Internal Application Diagrams
          • Overview
          • Web Model
          • Core Model
        • Service Interaction Flows
        • Data and State
          • Index
          • bf-manage-web
            • What this service is
            • Code anatomy
            • Architectural characteristics
            • Documentation and tests in-repo
          • bf-manage-core
          • bf-manage-connect
          • bf-manage-sitepwrmon
          • bf-manage-incidents
          • bf-telematics
          • bf-depot-sim
          • bf-manage-roaming
          • bf-support-microsite
          • bf-digital-twin
          • bf-schedule-creator
        • Overview
        • Internal Application Diagrams
        • Migration and Flags
        • Simulation Request Lifecycle
          • Index
          • bf-bnl-ui
          • bf-bnl-settings
          • bf-bnl-schedule-analysis-compute
          • bf-route-modelling
          • bf-schedule-creator
          • bf-digital-twin
        • Overview
        • Secrets and Env Strategy
        • Vendors and Local Dependencies
        • ADRs
        • Service Matrix
        • Cloud Dependencies
        • Ports and URLs
      • Onboarding
      • Daily Operations Runbook
        • Overview
        • Staging Hotfix Release
        • Production Hotfix Release
        • Terraform Plan Dry Runs
      • Troubleshooting
      • Testing Guide
    • What this service is
    • Code anatomy
    • Architectural characteristics
    • Documentation and tests in-repo

    bf-manage-web¶

    What this service is¶

    bf-manage-web is the primary Manage frontend. It is a Vite + React TypeScript application that composes operational workflows (chargers, depots, incidents, reports, dispatch, timeline, settings) and fans out API calls to multiple backend services.

    Code anatomy¶

    • src/router, src/navigation: routing, guarded routes, side-nav and navigation shell.
    • src/pages/*: feature screens such as Depot, Charger, Incidents, Reports, Timeline, SystemAdmin, Help.
    • src/components/*: design system layers (atoms, molecules, organisms, modals, layout helpers).
    • src/services/*: API client modules grouped by domain (depotSim, tariffs, permissions, reports, schedules, troubleshooting, telematics).
    • src/hooks/*: app-wide behavior hooks (feature flags, axios wiring, workspace view, time handling, modal/state helpers).
    • src/context/*: cross-page state providers (workspace/account/user state and UI contexts).
    • src/queries/*: request/query abstractions for data flows.

    Architectural characteristics¶

    • Component-driven UI with service modules rather than page-level direct HTTP calls.
    • Heavy usage of custom hooks for cross-cutting behavior and feature gating.
    • Multi-backend integration model where URL wiring is env-driven and mode/feature-flag aware.

    Documentation and tests in-repo¶

    • feature-flags.md, frontend_feature_flags_admin_page.md.
    • In-app help source of truth: docs/help/; editing workflow: In-App Docs Authoring.
    • Cypress suite in cypress/ plus service/hook unit tests under src/.
    Made with Material for MkDocs