Activity Feed

The activity feed is your central hub for tracking feature flag changes across all your connected repositories. Every flag addition, removal, and modification is logged with full context.

Overview

The activity feed shows:

• New flags added in pull requests
• Removed flags cleaned up from code
• Modified flags with changed usage
• PR merges that affect flag state
• Cleanup PRs created by FlagShark

Event Types

Flag Added

When a new feature flag is detected in a PR:

🟢 Flag Added: enable-new-checkout
   Repository: acme/web-app
   PR: #234 "Add new checkout flow"
   File: src/checkout/PaymentForm.tsx:42
   Author: @sarah
   2 hours ago

Click the event to see:

• Full file path and line number
• SDK method used
• Default value
• Link to the PR diff

Flag Removed

When flag code is deleted:

🔴 Flag Removed: enable-old-search
   Repository: acme/web-app
   PR: #267 "Remove deprecated search flag"
   Files affected: 3
   Author: @mike
   1 day ago

Removed flags are marked as "Cleaned Up" in your flag inventory.

Flag Modified

When flag usage changes:

🟡 Flag Modified: enable-dark-mode
   Repository: acme/web-app
   PR: #289 "Update dark mode defaults"
   Change: Default value changed from false to true
   Author: @alex
   3 days ago

PR Merged

When a PR containing flags is merged:

✅ PR Merged: #234 "Add new checkout flow"
   Repository: acme/web-app
   Flags added: 2 (enable-new-checkout, show-upsells)
   Flags removed: 0
   Author: @sarah
   2 hours ago

Cleanup PR Created

When FlagShark generates a cleanup PR:

🧹 Cleanup PR Created: #301
   Repository: acme/web-app
   Flag: enable-legacy-api
   Reason: Flag at 100% for 45 days
   Files to modify: 4
   Just now

Filtering the Feed

By Repository

Filter to see activity for specific repositories:

By Event Type

Show only certain event types:

• All events
• Flags added
• Flags removed
• PRs merged
• Cleanup PRs

By Time Range

Filter by time period:

• Last 24 hours
• Last 7 days
• Last 30 days
• Custom range

By Author

Filter by who made the change:

• All authors
• Specific team member
• Your changes only

Activity Details

Expanding Events

Click any event to see full details:

Code Preview

For flag additions and removals, see the actual code:

// Code preview in activity detail
+ const showUpsells = ldClient.variation('show-upsells', user, false);
+ if (showUpsells) {
+   return <UpsellBanner />;
+ }

Related Flags

If a PR affects multiple flags, see them all:

PR #234 affects 3 flags:
├── enable-new-checkout (added)
├── show-upsells (added)
└── use-legacy-api (removed)

Real-Time Updates

The activity feed updates in real-time:

Real-time updates are powered by WebSocket connections. You'll see a live indicator when connected:

Screenshot needed: FlagShark Dashboard → Live indicator

Green 'Live' badge showing real-time connection is active

Notifications

In-App Notifications

Get notified of important events:

• New flags in repositories you watch
• Flags reaching cleanup threshold
• Cleanup PRs ready for review

Email Digests

Configure email notifications:

Searching Activity

Search across all activity:

Search: "checkout"
Results:
- Flag Added: enable-new-checkout (2 hours ago)
- Flag Removed: legacy-checkout-flow (1 week ago)
- PR Merged: "Checkout improvements" (3 weeks ago)

Search covers:

• Flag names
• PR titles
• Repository names
• File paths
• Author names

Exporting Activity

Export activity data for reporting:

Export includes:

• Timestamp
• Event type
• Flag name
• Repository
• PR number and title
• Author
• File paths

Activity Insights

Summary Statistics

At the top of the feed, see:

Metric	This Week	Trend
Flags added	12	+3 from last week
Flags removed	8	+5 from last week
Net change	+4	-

Activity Patterns

Identify patterns:

• Which repositories are most active?
• Who's adding the most flags?
• What's the cleanup rate?

Team Collaboration

Mentions

In PR descriptions, mention flags for better tracking:

This PR adds `enable-new-checkout` for gradual rollout.
Cleanup target: March 15

Comments

Add comments to activity events:

API Access

Access activity programmatically:

# Get recent activity
curl -H "Authorization: Bearer $TOKEN" \
  https://api.flagshark.io/v1/activity

# Filter by repository
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.flagshark.io/v1/activity?repo=acme/web-app"

Related Documentation

• GitHub Comments - Flag info in PR comments
• Cleanup PRs - Automated flag removal
• Team Workflows - Team collaboration patterns