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
Repo Topology
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
          • Repository Types
          • Downstream Service Sources
          • Local State in bf-dev
        • CI and Release Integration
        • Overview
        • Internal Application Diagrams
          • Overview
          • Web Model
          • Core Model
        • Service Interaction Flows
        • Data and State
          • Index
          • bf-manage-web
          • 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
    • Repository Types
    • Downstream Service Sources
    • Local State in bf-dev

    Repository Map¶

    Repository Types¶

    flowchart TB
  BFDev[bf-dev] --> Scripts[Orchestration scripts]
  BFDev --> Compose[Compose definition]
  BFDev --> EnvTemplates[Environment templates]
  BFDev --> ServiceRepos[cloned service repos]
  BFDev --> Tests[repo-level smoke tests]

    Downstream Service Sources¶

    projects.txt maps GitLab repositories to local directories. Entries can target either top-level repo folders or nested local paths that mirror GitLab groups, such as integrations/<repo>, packages/<repo>, or deeper subgroup paths like integrations/<group>/<repo>. Example categories:

    • Manage repos (bf-manage-*, bf-telematics)
    • Plan repos (betterfleet-bnl-*, service-route-modelling, bf-digital-twin)
    • Shared/system repos (bf-support-microsite)
    • Grouped integration and package repos (integrations/*, packages/*)

    Local State in bf-dev¶

    • profile.ini: active service selection (generated/edited locally)
    • .env: root runtime settings (generated by ./init)
    • */.env: service-specific runtime settings (generated by ./init)
    • .agents/skills: BFDev-managed local skill catalog
    • .agents/third-party-skills.txt: required third-party skill manifest
    Made with Material for MkDocs