Skip to content

Add governance onboarding UI flow and reusable wizard primitives#57

Draft
Copilot wants to merge 5 commits into
copilot/plan-governance-homepage-componentsfrom
copilot/plan-governance-ui-onboarding-components
Draft

Add governance onboarding UI flow and reusable wizard primitives#57
Copilot wants to merge 5 commits into
copilot/plan-governance-homepage-componentsfrom
copilot/plan-governance-ui-onboarding-components

Conversation

Copilot AI commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

This adds the planned 5-step governance onboarding flow as a UI-only surface for the governance widget, with light/dark-ready states for identity verification, house selection, house-specific profile forms, stake progress, and success. It also introduces the shared flow primitives needed to support this pattern consistently across widgets.

  • Reusable UI primitives

    • Added PageWizard to @goodwidget/ui for horizontal multi-step flows with shared step/data state
    • Added Stepper to @goodwidget/ui for transaction/progress tracking states (pending, active, completed, failed, attention)
  • Governance onboarding widget

    • Added new @goodwidget/governance-widget package
    • Implemented a presentational GovernanceOnboardingWidget with:
      • welcome / identity state
      • house selection for Citizenship vs Alignment
      • house-specific profile forms mapped to the planned contract input shape
      • stake progress tracker
      • success state with configurable CTA set
    • Kept runtime concerns out of scope: no transaction wiring, no contract execution, no production data integration
  • State contract and flow behavior

    • Added explicit props/state for:
      • selected house
      • identity status
      • profile draft + field errors
      • stake amount label
      • transaction step statuses
      • final action configuration
    • Preserved selection across later steps in the interactive flow
  • Storybook and smoke coverage

    • Added governance onboarding stories under examples/storybook/src/stories/governance-widget/
    • Covered both review contexts and key states:
      • injected and custodial wallet shells
      • unverified / verified welcome
      • house selection
      • citizenship ready profile
      • alignment validation/error profile
      • failed stake progress
      • success state
    • Added widget smoke coverage and screenshot evidence under tests/widgets/governance-widget/
  • Example

    <GovernanceOnboardingWidget
      currentStepId="profile"
      identityStatus="verified"
      initialHouse="alignment"
      stakeAmountLabel="250 G$"
      initialProfileDraft={{
        name: 'Solar Commons',
        projectWebpage: 'https://solar.example',
      }}
      initialFieldErrors={{
        missionStatement: 'Mission statement is required',
        distributionStrategy: 'Distribution strategy is required',
      }}
    />

Copilot AI changed the title [WIP] Build governance UI onboarding components Add governance onboarding UI flow and reusable wizard primitives Jun 16, 2026
Copilot AI requested a review from L03TJ3 June 16, 2026 14:10
@L03TJ3

L03TJ3 commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

@copilot the skills folder commited should not. please remove

Copilot AI commented Jun 16, 2026

Copy link
Copy Markdown
Contributor Author

@copilot the skills folder commited should not. please remove

Addressed in commit 05a6658: removed the committed .agents/skills folder from this branch.

@L03TJ3 L03TJ3 changed the base branch from main to copilot/plan-governance-homepage-components June 16, 2026 16:00
…-components' into copilot/plan-governance-ui-onboarding-components
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.

[PLAN] Governance UI onboarding components [Feature]: Governance UI Onboarding components

2 participants