feat: release-ready flutter_border_beam — API, features, tests, CI, docs, segments

.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# Code owners are requested for review automatically on every PR.
+# A GitHub team (e.g. @SimplifyJobs/mobile) can replace the individual owner
+# once one exists — teams survive people changing roles.
+
+*           @rehmatsg
+
+/.github/   @rehmatsg

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,110 @@
+name: Bug report
+description: Something renders, animates, or behaves incorrectly.
+title: "[bug]: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report. If you can reproduce it in the
+        [live playground](https://simplifyjobs.github.io/flutter_border_beam/),
+        paste the share link — it carries the exact configuration and saves
+        everyone a round trip.
+
+        Security issues do **not** belong here — see
+        [SECURITY.md](https://github.com/SimplifyJobs/flutter_border_beam/blob/main/SECURITY.md).
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened
+      description: A short description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      description: >-
+        The smallest widget tree that shows the problem — ideally one that
+        drops straight into a fresh `flutter create` app. A playground share
+        link works too.
+      render: dart
+      placeholder: |
+        BorderBeam.rotate(
+          colors: BeamColors.ocean,
+          child: const SizedBox(width: 240, height: 120),
+        )
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+
+  - type: input
+    id: variant
+    attributes:
+      label: Variant(s) and palette
+      description: Which `BeamVariant` and which `BeamColors` (or custom colors).
+      placeholder: "rotate + line; BeamColors.colorful"
+    validations:
+      required: true
+
+  - type: textarea
+    id: flutter-version
+    attributes:
+      label: "`flutter --version` output"
+      description: Paste the whole thing — the Dart version and channel matter.
+      render: shell
+    validations:
+      required: true
+
+  - type: input
+    id: package-version
+    attributes:
+      label: flutter_border_beam version
+      placeholder: "0.1.0"
+    validations:
+      required: true
+
+  - type: input
+    id: platform
+    attributes:
+      label: Device / OS
+      description: >-
+        Include the web renderer (canvaskit or skwasm) and the browser if this
+        is on web; include the simulator/emulator vs. physical device
+        otherwise.
+      placeholder: "iPhone 16 simulator, iOS 26.0 / Chrome 141 on macOS, canvaskit"
+    validations:
+      required: true
+
+  - type: textarea
+    id: media
+    attributes:
+      label: Screenshot or video
+      description: >-
+        Strongly encouraged — this package is a visual one, and a five-second
+        screen recording usually says more than a paragraph. Drag files in.
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Anything else
+      description: Logs, a stack trace, what you already tried.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question or idea
+    url: https://github.com/SimplifyJobs/flutter_border_beam/discussions
+    about: Ask how to do something, or float an idea before it becomes a proposal.
+  - name: Live playground
+    url: https://simplifyjobs.github.io/flutter_border_beam/
+    about: Try variants and palettes in the browser, then share the exact configuration.
+  - name: Security vulnerability
+    url: https://github.com/SimplifyJobs/flutter_border_beam/security/advisories/new
+    about: Report privately. Never in a public issue.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,74 @@
+name: Feature request
+description: Propose a new variant, option, palette, or API.
+title: "[feat]: "
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This package is a port of the
+        [border-beam](https://github.com/Jakubantalik/border-beam) React
+        library. Features that exist upstream are the easiest sell — say so if
+        yours does, and link the source. Flutter-only additions are welcome
+        too; they just need to stay out of the parity tables.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: The problem
+      description: >-
+        What are you trying to build, and where does the package get in the
+        way? Describe the situation, not the solution.
+    validations:
+      required: true
+
+  - type: textarea
+    id: api
+    attributes:
+      label: Proposed API
+      description: >-
+        A sketch of the call site as you would want to write it. Rough is
+        fine — the shape is what matters.
+      render: dart
+      placeholder: |
+        BorderBeam.rotate(
+          style: const BeamStyle(tailLength: 0.4),
+          child: ...,
+        )
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: >-
+        What can you do today instead, and why is it not enough? Include any
+        workaround you are currently shipping.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: rendering-defaults
+    attributes:
+      label: Does this change rendering defaults?
+      description: >-
+        Would an existing `BorderBeam` with no new arguments look or animate
+        differently? That makes it a breaking visual change, which needs a
+        much stronger case and regenerated goldens.
+      options:
+        - "No — purely additive, defaults unchanged"
+        - "Yes — existing beams would render differently"
+        - "Not sure"
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Anything else
+      description: >-
+        References, a link to the React implementation, screenshots or a
+        mockup of the effect.
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,56 @@
+## Summary
+
+<!--
+What changed and why, in a short paragraph. Link the issue it closes
+(`Closes #12`). If this changes what a beam looks like, say so here — that is
+the first thing a reviewer needs to know.
+-->
+
+## Changes
+
+<!--
+Bullets, each opening with a bold lead-in naming the area:
+
+- **Painting** (`lib/src/painting/`) — …
+- **Docs** — …
+-->
+
+-
+
+## Testing
+
+<!--
+What you actually ran, and what it said. Do not claim a check you skipped —
+"goldens not run (no macOS)" is a fine and useful answer.
+-->
+
+- [ ] `dart format .` — clean
+- [ ] `flutter analyze --fatal-infos` — zero issues (package and `example/`)
+- [ ] `flutter test` — green (`--exclude-tags golden` if you are not on macOS)
+
+**Goldens** — none regenerated / regenerated:
+
+<!--
+If you regenerated any: list which scenes, and why the pixels legitimately
+moved (a new blur radius, a corrected gradient stop, a Flutter pin bump).
+Goldens are macOS-only and pinned to Flutter 3.44.2; regenerate only your own
+new scenes, with `--plain-name`.
+-->
+
+**saveLayer budget** — unchanged / changed:
+
+<!--
+If `test/painting/save_layer_budget_test.dart`'s table changed: which variants,
+the new counts, and what the added layer composites that no existing layer
+could. Both the test and CLAUDE.md's table have to move together.
+-->
+
+## Checklist
+
+- [ ] No values in `lib/src/constants/` were tweaked (they are verbatim
+      transcriptions of the React source); Flutter-only additions live in a
+      clearly headed file
+- [ ] New public API has doc comments (`public_member_api_docs` is enforced)
+- [ ] Docs and comments describe current behavior — no change-history prose
+- [ ] `CHANGELOG.md` updated
+- [ ] README updated if this changes what a user reaches for first

.github/dependabot.yml

@@ -0,0 +1,34 @@
+# Weekly dependency updates, grouped so each ecosystem lands as a single PR
+# rather than one PR per bump.
+version: 2
+
+updates:
+  # GitHub Actions used by ci.yaml and release.yaml.
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+    commit-message:
+      prefix: ci
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+
+  # Dart/Flutter dependencies for the package and the example gallery.
+  - package-ecosystem: pub
+    directories:
+      - /
+      - /example
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+    commit-message:
+      prefix: chore
+    groups:
+      pub:
+        patterns:
+          - "*"

.github/labels.yml

@@ -0,0 +1,41 @@
+# The repository's label set, kept in version control so it is reviewable.
+#
+# Nothing syncs this automatically yet — applying it means either creating the
+# labels by hand or wiring a sync action (e.g. crazy-max/ghaction-github-labeler)
+# that reads this file. Until then, treat it as the source of truth a human
+# reconciles against.
+#
+# `dependencies` is the one label that is already load-bearing: dependabot.yml
+# applies it to every update PR it opens.
+
+- name: bug
+  color: d73a4a
+  description: Something renders, animates, or behaves incorrectly.
+
+- name: enhancement
+  color: a2eeef
+  description: A new variant, option, palette, or API.
+
+- name: documentation
+  color: 0075ca
+  description: README, doc comments, or the guides in this repo.
+
+- name: rendering
+  color: 8a63d2
+  description: Painting, geometry, gradients, goldens — anything about the pixels.
+
+- name: performance
+  color: fbca04
+  description: Frame cost, saveLayer budget, repaint churn, memory.
+
+- name: good first issue
+  color: 7057ff
+  description: Self-contained and well-scoped — a good place to start.
+
+- name: help wanted
+  color: 008672
+  description: Maintainers would welcome a contributor picking this up.
+
+- name: dependencies
+  color: 0366d6
+  description: Dependency and GitHub Actions updates (applied by dependabot).