data/custom/example/satvis.yaml

# Example plugin config. Every data/custom/*/satvis.yaml is merged into the core
# config by worker/scripts/generate-groups.mjs at build time.
#
# A config contributes two independent sections, both optional:
#   groups     — what is served, and as which unit
#   satellites — static per-satellite facts, keyed by NORAD id, attached to
#                matching records wherever they are served

groups:
  - name: iss
    sources: [{ celestrak: stations }]
    satellites:
      # A group row selects and renames. It may also carry `metadata`, which is
      # lifted into the merged satellite table under its noradId — so it applies
      # wherever the record is served, not only in this group. Use it when the
      # row already exists; use the top-level `satellites` table below otherwise.
      - { noradId: 25544, upstreamName: ISS (ZARYA), name: ISS }

# Static facts for satellites this plugin knows about, keyed by NORAD id alone
# (`name` is documentation only). Left empty on purpose: this example IS discovered
# by the generator and merged into the served config, so a value here would change
# what every build renders. Uncomment to attach facts of your own.
#
# Swath extents are PER-SIDE cross-track distances (km) from the ground track,
# relative to flight direction (starboard = velocity bearing + 90°) — not halves of
# a full width, and given for both sides or neither.
#
# satellites:
#   - { noradId: 25544, name: ISS, swathStarboardKm: 100, swathPortKm: 100, coneFovDeg: 45 }