Analytics

Tastemakers · Product Analytics Overview · 2 tracking, 7 planned

01Development Velocity

114
Total Items
14
Avg / Session
31
Peak (Session 1)
8
Sessions
-10
Last vs Avg
Session 1
31
Backend audit & docs
Session 2
7
Web scaffold
Session 3
19
API contract mapping
Session 4
11
Security audit
Session 5
5
Android assessment
Session 6
23
/tech + /roadmap pages
Session 7
14
Changelog, status, admin
Session 8
4
Analytics page
— Avg: 14 items/session— Peak: 31 (Session 1)— Trend: Audit → Build (shifted from findings to features after Session 4)

Breakdown by Contribution Type

55
findings
41
features
10
security
5
docs
2
refactor
1
performance

02Product Metrics

2 Tracking7 Planned3 Not Started
Page Views & Navigationplanned

Track which pages users visit, session duration, bounce rate, and navigation flow between pages.

EngagementPostHog / Google Analytics
User Identity & Authplanned

Login method distribution (email vs Google vs Apple), signup funnel drop-off, session length by auth type.

IdentityLaravel Passport logs + PostHog
Restaurant Discoveryplanned

Search queries, Foursquare API hit rate, restaurant save rate, average restaurants viewed per session.

Core FeatureAPI logs + PostHog events
Tagging Adoptionplanned

Tags created per user, most popular tags, tag-to-restaurant ratio, search-by-tag conversion rate.

Core FeaturePostgreSQL queries
List Engagementplanned

Lists created, restaurants per list, list bookmark rate, tastemaker follow rate, list share clicks.

SocialAPI events + PostHog
Image Interactionsplanned

Photos uploaded per restaurant, like rate, report rate, average images viewed per session.

ContentAPI events
API Performanceplanned

P50/P95/P99 response times, error rate by endpoint, Foursquare API latency, database query time.

PerformanceLaravel Telescope / APM
Development Velocitytracking

Items shipped per session, bug fix rate, findings resolved, LOC delta per sprint.

Dev OpsGit history + todos/ directory
Code Health Scoretracking

Security findings open/closed, test coverage %, lint errors, TypeScript strict compliance.

Dev Ops/roadmap health scorecard
Click & Interaction Trackingnot-started

CTA clicks, filter usage, map interactions, accordion expand/collapse, scroll depth.

UXPostHog autocapture
Geolocation Usagenot-started

Users granting location permission, nearby search frequency, average search radius, city distribution.

Core FeatureBrowser Geolocation API + API logs
Push Notification Engagementnot-started

FCM delivery rate, open rate by notification type, opt-in rate, time-to-open.

EngagementFirebase Analytics

03Key Questions

highAre users discovering restaurants or just browsing?3 metrics

Measure search-to-save conversion rate. If users search but rarely save, the discovery UX needs work. Track Foursquare API calls vs restaurant_user inserts.

Search countSave rateFoursquare API calls
Source: API logs + restaurant_user table
highWhich auth method converts best?3 metrics

Compare signup completion rates across email, Google OAuth, and Apple Sign-In. Check 30-day retention by auth method — social logins often have higher activation but lower retention.

Signup funnel by method30-day retentionSession frequency
Source: users table (user_type column) + Passport token logs
highIs the tagging system adding value?3 metrics

Check tag creation rate and search-by-tag usage. If tags are created but rarely searched, they're not helping discovery. Compare search results click-through with vs without tag filters.

Tags per userSearch-by-tag queriesTag filter CTR
Source: restaurant_tag pivot + API search logs
mediumDo tastemaker lists drive engagement?4 metrics

Track list creation → follow → bookmark funnel. Measure if users who follow tastemakers have higher retention and session frequency than non-followers.

Lists createdFollow rateBookmark rateRetention delta
Source: testmaker_list + testmaker_follow tables
mediumWhat's the real API performance under load?3 metrics

The N+1 query issue in restaurantDetails means latency scales linearly with tastemaker count. Measure P95 response time now, fix the N+1, then re-measure. Target: <200ms for all endpoints.

P95 latencyQueries per requestFoursquare API time
Source: Laravel Telescope or custom middleware timing
mediumIs the iOS app still the primary client?3 metrics

Compare DAU across iOS, Android, and web. The iOS app has 617 commits and 25 screens — it's the most mature client. Web and Android are new. Track platform distribution over time.

DAU by platformFeature parity %API calls by client
Source: device_type column in users + API request User-Agent headers
highHow fast are we resolving security debt?3 metrics

Track P1 findings open vs closed over time. Currently 15 P1 items open, 0 closed. Velocity here directly impacts production safety. Target: all P1 security items closed within 3 sessions.

P1 open countP1 close rateDays to resolution
Source: todos/ directory + git history
lowWhat's the cost-per-feature of AI-assisted development?3 metrics

Divide Claude Code API cost by features shipped. Compare human hours per feature vs traditional estimates. Track which tasks AI accelerates most (audit, boilerplate, docs) vs least (architecture decisions, security fixes).

API cost/sessionHuman hours/featureAI acceleration factor
Source: Claude Code usage logs + session notes

04Analytics Platform

PostHogrecommended

Open-source product analytics with autocapture, session replays, feature flags, and A/B testing. Self-hostable for full data control.

  • Autocapture (no manual event code)
  • Session replays
  • Feature flags & A/B tests
  • Funnels & retention charts
  • Self-hostable (data privacy)
  • Free tier: 1M events/mo
Mixpanelalternative

Event-based analytics focused on user behavior, funnels, and cohort analysis. Strong mobile SDK support.

  • Event-based tracking
  • Funnel & cohort analysis
  • Mobile SDKs (iOS + Android)
  • Real-time dashboards
  • Free tier: 20M events/mo
Git + Todos (Current)current

Development velocity and code health are currently tracked via git history, todos/ directories, and the /roadmap health scorecard. No product analytics in production yet.

  • Commit history & LOC tracking
  • 50 findings tracked in todos/
  • Health scorecard on /roadmap
  • Session velocity on /roadmap
  • Manual — no automated collection

Ready to Instrument

The codebase is structured for analytics — all user actions flow through typed API endpoints. Adding PostHog requires one npm install posthog-js and a provider wrapper in the root layout.

View RoadmapUnder the Hood