Skip to content

feat: add 4-step sponsor onboarding flow#39

Merged
EmeditWeb merged 2 commits into
StepFi-app:mainfrom
daRk8238:implement-sponsor-onboarding
Jun 17, 2026
Merged

feat: add 4-step sponsor onboarding flow#39
EmeditWeb merged 2 commits into
StepFi-app:mainfrom
daRk8238:implement-sponsor-onboarding

Conversation

@daRk8238

Copy link
Copy Markdown
Contributor

Summary

New sponsors currently land directly on the dashboard with no context or guidance about how the pool works. This PR adds a 4-step onboarding flow at /sponsors/onboarding that educates new sponsors before they deposit.

Changes

New files

  • src/pages/SponsorOnboarding.tsx — 4-step onboarding page with framer-motion transitions:
    1. Welcome — Explains the sponsor pool concept and how depositing funds learner loans
    2. Risks — Honest risk disclosure covering default risk, smart contract risk, liquidity risk, and protocol risk
    3. Pool Health — Live pool stats (total deposits, APY, available liquidity, locked liquidity) loaded from API via React Query, plus a yield preview calculator
    4. Deposit — Wallet connection prompt with link to GrantFox; marks onboarding as complete
  • src/services/pool.service.ts — API service for fetching pool info (GET /api/v1/pool)

Modified files

  • src/stores/app.store.ts — Added onboardingComplete state (persisted via zustand/persist) to track whether a user has completed onboarding
  • src/router/index.tsx — Added /sponsors/onboarding route

Verification

  • npm run build passes
  • No any types used
  • Smooth step transitions with AnimatePresence
  • Yield preview calculates yearly/monthly returns from real-time APY
  • Back navigation supported between steps

Closes #29

@EmeditWeb EmeditWeb merged commit 9c920fb into StepFi-app:main Jun 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

core: implement sponsor onboarding flow

2 participants