How agniv-dutta/beyond-the-crease works
Beyond the Crease is a browser-only sports visibility and fan-engagement prototype. Visitors browse match and athlete coverage into stories; the Studio generates and fairness-checks drafts before publishing, while Parity visualizes illustrative visibility data and Circles support moderated fan interaction. The app exposes these capabilities through routed pages backed by a typed resolver API, fictional datasets, local state, and an in-browser webhook bus. README documents major features whose page implementations were not sampled; those nodes are retained, but unsampled internal call paths are not inferred.
Main entry points: App.tsx Route shell · client.ts API client · StudioPage.tsx Story Studio · bus.ts Event bus
Components 28
Fan experience
- Story feed
src/pages/HomePage.tsx - Live matches
src/pages/LivePage.tsx - Match detail
src/pages/MatchPage.tsx - Athlete discovery
src/pages/AthletesPage.tsx - Athlete profile
src/pages/AthletePage.tsx - Fan circles
src/pages/CirclesPage.tsx - Circle chat
src/pages/CirclePage.tsx
Storytelling
- Story reader
src/pages/StoryPage.tsx - Story Studio
src/pages/StudioPage.tsx - Draft generator
src/api/storyEngine.ts - Fairness scoring
src/utils/fairness.ts - Share card
src/components/story/ShareCardModal.tsx
Visibility insight
- Parity tracker
src/pages/ParityPage.tsx - Visibility data
src/data/visibility.ts
App platform
- Route shell
src/App.tsx - Access settings
src/pages/AccessPage.tsx - API client
src/api/client.ts - API resolvers
src/api/resolvers.ts - Feed hook
src/hooks/useFeed.ts - Async state
src/hooks/useAsync.ts - Demo datasets
src/data/athletes.ts - Data selectors
src/data/selectors.ts - Translations
src/i18n/resources.ts
Local services
- User preferences
src/store/prefs.ts - Fan rewards
src/store/gamification.ts - Event bus
src/webhooks/bus.ts - Safety state
src/store/safety.ts
Other components
- Fan
Connections 42
- Fan → Route shell: opens
src/App.tsx - Route shell → Story feed: routes to
src/App.tsx - Route shell → Live matches: routes to
src/App.tsx - Route shell → Match detail: routes to
src/App.tsx - Route shell → Story reader: routes to
src/App.tsx - Route shell → Athlete discovery: routes to
src/App.tsx - Route shell → Athlete profile: routes to
src/App.tsx - Route shell → Story Studio: routes to
src/App.tsx - Route shell → Parity tracker: routes to
src/App.tsx - Route shell → Fan circles: routes to
src/App.tsx - Route shell → Circle chat: routes to
src/App.tsx - Route shell → Access settings: routes to
src/App.tsx - Story feed → Feed hook: loads feed
- Feed hook → API client: requests
src/hooks/useFeed.ts - Feed hook → Async state: uses
src/hooks/useFeed.ts - Async state → API client: runs fetcher
- API client → API resolvers: fallback calls
src/api/client.ts - API resolvers → Data selectors: queries
src/api/resolvers.ts - API resolvers → Demo datasets: reads
src/api/resolvers.ts - API resolvers → Draft generator: dispatches
src/api/resolvers.ts - Data selectors → Demo datasets: selects from
src/data/selectors.ts - Story Studio → API client: requests
src/pages/StudioPage.tsx - Story Studio → Draft generator: generates drafts
src/api/storyEngine.ts - Draft generator → Fairness scoring: scores copy
src/api/storyEngine.ts - Story Studio → Fairness scoring: checks and fixes
src/pages/StudioPage.tsx - Story Studio → Share card: opens
src/pages/StudioPage.tsx - Story Studio → Event bus: publishes event
src/pages/StudioPage.tsx - Circle chat → API client: requests
src/pages/CirclePage.tsx - Circle chat → Event bus: emits message
src/pages/CirclePage.tsx - Circle chat → Safety state: uses moderation
src/pages/CirclePage.tsx - Athlete profile → API client: loads profile
src/pages/AthletePage.tsx - Athlete profile → Event bus: emits alerts
src/pages/AthletePage.tsx - Athlete profile → Fan rewards: updates rewards
src/pages/AthletePage.tsx - Access settings → User preferences: updates settings
src/pages/AccessPage.tsx - Access settings → Safety state: reads and updates
src/pages/AccessPage.tsx - User preferences → Translations: sets language
src/store/prefs.ts - Fan rewards → Event bus: emits milestones
src/store/gamification.ts - Parity tracker → Visibility data: visualizes
- Match detail → API client: loads match
- Live matches → Event bus: simulates events
- Story reader → API client: loads story
- Fan circles → API client: loads rooms