How gpbsumido/paul-explore works
paul-explore is a personal portfolio and interactive playground: visitors explore featured apps, experiments, and technical write-ups. The main journey begins at the landing page or Discover, then branches into domain tools and learning content; authenticated users also use personal and administrative features. Server routes provide feature APIs and proxy selected external services. The README documents capabilities beyond the sampled source, so those appear as product areas without speculative implementation links; detailed wiring is shown only where the excerpts support it.
Main entry points: OperatorDashboard.tsx Fleet operator · FlagsConsole.tsx Feature flags · ResearchContent.tsx Research explorer · useRestockSession.ts Restock session
Components 27
Portfolio and discovery
- Landing page
src/app/LandingContent.tsx - Discover
src/app/discover/page.tsx - Explore Toronto
src/app/world/audio/engine.ts - Work portfolio
src/app/work-portfolio/demos/ai-content-engine.tsx
Interactive tools
- Design system
src/app/design-system/page.tsx - Feature flags
src/app/flags/FlagsConsole.tsx
Domain applications
- Research explorer
src/app/research/ResearchContent.tsx - Fleet operator
src/app/operator/OperatorDashboard.tsx - Restock session
src/hooks/useRestockSession.ts - Volunteer check-in
src/app/check-in/CheckInContent.tsx - Calendar
src/app/calendar/CalendarContent.tsx - Fantasy sports
src/app/fantasy/nba/FantasyHubContent.tsx - Pokémon TCG
src/app/tcg/pokemon/BrowseContent.tsx - Pokédex
src/app/graphql/GraphQLContent.tsx - Web Vitals
src/app/api/vitals/route.ts
API and integrations
- Flags API
src/app/api/flags/[flagKey]/route.ts - Flag evaluation
src/lib/flags-engine.ts - Research API
src/app/api/research/journal-club/route.ts - Europe PMC
- Restock API
src/app/api/operator/restock-sessions/[sessionId]/route.ts - GraphQL proxy
src/app/api/graphql/route.ts - PokeAPI
- Portfolio API
Learning and writing
Other components
- Visitor
- Signed-in member
Connections 26
- Visitor → Landing page: visits
- Visitor → Discover: explores
- Visitor → Explore Toronto: explores
- Visitor → Work portfolio: views
- Visitor → Design system: explores
- Visitor → Research explorer: uses
- Visitor → Feature flags: evaluates
- Visitor → Fleet operator: views
- Visitor → Volunteer check-in: checks in
- Visitor → Fantasy sports: plays
- Visitor → Pokémon TCG: browses
- Visitor → Pokédex: explores
- Visitor → Learn: studies
- Visitor → Thoughts: reads
- Signed-in member → Calendar: manages
- Signed-in member → Volunteer check-in: checks in
- Signed-in member → Fleet operator: operates
- Feature flags → Flags API: manages flags
- Flags API → Flag evaluation: evaluates
- Research explorer → Research API: requests papers
- Research API → Europe PMC: searches
- Fleet operator → Restock session: starts restocking
- Restock session → Restock API: fetches and updates
- Pokédex → GraphQL proxy: requests data
- GraphQL proxy → PokeAPI: forwards query
- Web Vitals → Portfolio API: forwards beacons; reads aggregates