Skip to content

Feat/customizable login UI - #148

Merged
Adedamola18 merged 8 commits into
mainfrom
feat/customizable-login-ui
Jul 29, 2026
Merged

Feat/customizable login UI#148
Adedamola18 merged 8 commits into
mainfrom
feat/customizable-login-ui

Conversation

@Adedamola18

@Adedamola18 Adedamola18 commented Jul 28, 2026

Copy link
Copy Markdown
Member

Closes https://github.com/IQIndustries/issues/issues/5147 when this PR merged

What

Makes the Login component's UI customizable per project while keeping the default look 100% unchanged for existing consumers, and adds a headless hook for apps that want to own the entire login UI.

1. Login customization props (all optional)

  • variant"page" (default, current layout) or "card" (renders only the card, so apps can place it in their own modal)
  • classNames — per-slot class overrides across 27 named slots (card, connectorButton, connectorLabel, signButton, …), merged over the defaults with tailwind-merge so consumer classes win conflicts
  • connectorMeta — override label/description/icon per connector (Injected, WalletConnect, Web3Auth)
  • header / footer — ReactNode slots replacing the default heading block / rendering below the wallet list
  • renderConnector — render-prop escape hatch for full control of each wallet row

2. Headless useLoginFlow() hook

Packages everything Login uses internally — connectors with resolved metadata, connect actions and pending/error state, isConnected/address, and the sign-token step (token, signToken, signing, signError, logout, disableAuth). Apps (inside or outside the IQ ecosystem) can build a fully custom login screen with zero library markup. Must be used inside IqLoginProvider.

Backward compatibility

  • <Login /> with no props renders exactly as before — default class strings were extracted verbatim and verified character-for-character, plus side-by-side browser screenshot comparison against the previous release.
  • No changes to hooks, config, provider, or server code paths. Existing exports untouched; new types (LoginProps, LoginSlot, ConnectorMeta, ConnectorRow, LoginVariant, UseLoginFlowReturn, …) exported from @everipedia/iq-login/client.

@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@Adedamola18
Adedamola18 merged commit e2ab1d1 into main Jul 29, 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.

2 participants