# Tracking review (Feb 2026) – do we need to update?

**Branch:** `review/tracking-updates`  
**Context:** After recent changes (project gate modal, share links sign-in notice, overview hero default/RLS, admin deps, aria/upload fixes).

---

## Short answer

**No required changes.** Existing tracking (section_view, button_click, etc.) still applies. New UI is either covered by current events or is optional to add.

---

## What we changed (and tracking impact)

| Change | Tracking impact |
|--------|-----------------|
| **Project gate modal** (no project → “Select or create a project to continue”) | User can click “Open Project panel”. That button is a normal `<button>` and is already covered by **button_click** (when “Track buttons” is on). Section navigation still fires **section_view**. No code change needed. |
| **Share links sign-in notice** (guests see “Sign in to create and manage share links”) | No new clickable CTA that isn’t already a button/link. If you want to measure “guest opened Share Links panel and saw notice”, that would be an optional new event (see below). |
| **Overview hero** default “Blueprint Toolkit” + migration 076 (public read) | Content/RLS only. No new events or config. |
| **Admin** (updateContactButtonVisibility in deps), **aria focus**, **upload 409** | Bug/UX fixes. No tracking impact. |

---

## Optional additions (if you want funnel metrics)

- **Project gate**
  - `project_gate_shown` – when the gate modal is displayed (section + no project).
  - `project_gate_cta_click` – when user clicks “Open Project panel” from the gate (in addition to or instead of generic button_click for that button).
- **Share links (guests)**
  - `share_links_guest_notice_view` – when the Share Links panel is opened and the sign-in notice is shown (no account).

These are optional for funnels (e.g. “how often do guests hit the gate?” or “how many open Share Links while signed out?”). Not required for current TRACKING.md event catalog.

---

## Config and infra

- **app_settings:** We added public read for `overview_hero_title` / `overview_hero_description` only. `ga4_measurement_id` and `tracking_delivery` are unchanged; no tracking config update.
- **dataLayer / gtag / Edge Function:** No changes needed.

---

## Conclusion

- **Required:** None. Existing tracking is still correct.
- **Optional:** Add project_gate_* and/or share_links_guest_notice_view if you want those funnels; document them in TRACKING.md and wire in app-init/app-share-links as needed.