Skip to content

feat(frontend): frontend workspace is a single component - bootstrap a real application shell #665

Description

@phertyameen

Summary

The entire frontend/ workspace currently consists of one component: frontend/src/components/analytics/OnboardingFunnelChart.tsx. There are no pages/routes, no API client, and no auth flow - yet CI builds and type-checks it, and the README describes a player-facing product (IQ survey onboarding, adaptive puzzles, leaderboards). The backend exposes the needed surface via its Swagger-documented REST API, so the gap is purely frontend scaffolding.

Proposal (phased)

Phase 1 - shell:

  1. Confirm the stack implied by root dependencies (@tanstack/react-query, framer-motion) - i.e. a React/Vite app - and scaffold routing + layout.
  2. Typed API client generated from the Swagger document (/api-json) or a hand-rolled fetch wrapper with error normalization.
  3. Auth screens against the existing auth endpoints (Google OAuth server-side support exists via passport-google-oauth20; guest sessions via guest-session.provider.ts).

Phase 2 - core loops:
4. Puzzle browsing/solving view wired to puzzles + progress endpoints.
5. Streak & XP surfaces fed by streak/users endpoints.
6. Integrate the existing OnboardingFunnelChart into a dashboard route rather than leaving it orphaned.

Acceptance criteria

  • npm --workspace frontend run dev serves a navigable app.
  • Login (Google + guest) reaches the backend and stores tokens securely.
  • One vertical slice (browse puzzle -> submit answer -> see XP/streak update) works end-to-end locally.

Activity

  1. Kaylahray commented on Aug 27, 2026

    @Kaylahray
    Contributor

    Hi Maintainer, Please Assign

  2. grantfox-oss commented on Aug 27, 2026

    @grantfox-oss

    🦊 GrantFox — @Kaylahray has been assigned to this issue as part of the Third Campaign campaign!

    Next steps:

    1. Open a Pull Request referencing this issue (e.g., Closes #665)
    2. Your PR will be reviewed by the MindBlockLabs maintainers

    Good luck! Track your progress on GrantFox.

  3. grantfox-oss commented on Aug 29, 2026

    @grantfox-oss

    🎉 This issue has been marked as completed on GrantFox as part of the Third Campaign campaign!

    @Kaylahray's PR #672 was approved and merged by @A6dulmalik.

    🏆 @Kaylahray: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (529 total points). Track your full progress on GrantFox.

    👏 Great work, @Kaylahray! Keep contributing to MindBlockLabs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardThird CampaignCampaign: Third Campaign

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions