mirror of
https://github.com/supabase/supabase.git
synced 2026-09-08 10:59:38 +08:00
## What kind of change does this PR introduce?
Bug fix / docs UI polish.
## What is the current behavior?
- Many docs `GlassPanel`s use `background={false}`, so hover only tweaks
the border and reads as having no hover state
- Compact icon+label grids still use `IconPanel`, which has a broken
`-z-10` hover fill and overlaps with the newer `IconLink` pattern
- Description card grids jump to 3-up too early on medium widths
## What is the new behavior?
**GlassPanel**
- Removes the `background` prop; cards always use the filled surface
with stronger border hover
- Tightens icon→description gap (`gap-6` → `gap-3`)
- Decorative icons/logos use empty `alt` so screen readers don’t hear
the title twice
**Icon tiles**
- Retires `IconPanel` from docs and deletes it from `ui-patterns`
- Uses `IconLink` / `IconLinkList` for compact navigation tiles (auth
providers, social login, etc.)
- Adds `IconLinkButton` for SMS provider pickers (same chrome, opens a
dialog)
- Adds focus styles, list labelling, and dialog-trigger ARIA where
needed
**Layout / content**
- Migrate-to-Supabase description cards on resources use `GlassPanel`
(not slim icon tiles)
- Grid spans use `md:… xl:…` so cards stay 2-up until ~1280px
- Fixes migrate links to `/guides/platform/migrating-to-supabase/…` and
SSR quickstarts to `creating-a-client` with framework query params
- Moves the Extensions list `key` onto the outer `Link`
| Before | After |
| --- | --- |
| <img width="1185" height="1323" alt="Resources Supabase Docs"
src="https://github.com/user-attachments/assets/1677bf65-d3a3-4202-8c70-e758f7c3bcce"
/> | <img width="1185" height="1323" alt="Resources Supabase Docs"
src="https://github.com/user-attachments/assets/51760f0f-62b6-4010-9841-de26039f37b4"
/> |
## Additional context
Homepage compact sections already use `IconLinkList` from #48317; this
PR finishes that pattern for remaining docs `IconPanel` callsites and
cleans up GlassPanel hover.
`www/customers` only drops the removed `background` prop; those cards
already use the filled surface via `logo`.
## Test plan
- [ ] `/guides/getting-started`: GlassPanels show filled surface and
clearer border hover
- [ ] `/guides/resources`: migrate cards are GlassPanels with working
`/platform/…` links; 2-up until xl
- [ ] `/guides/auth/social-login` and auth providers partial: IconLink
tiles hover/focus correctly
- [ ] `/guides/auth/phone-login`: SMS provider buttons open dialogs;
keyboard focus works
- [ ] Docs homepage: migrate / self-host IconLinkLists unchanged in
behaviour
- [ ] `/guides/auth/server-side`: Next.js / SvelteKit cards resolve on
docs preview
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Improved Layouts**
* Made “GlassPanel” card grids more responsive and consistent; refined
card and success badge spacing for a cleaner presentation.
* **Updated Documentation**
* Refreshed multiple guide and resource pages (including quickstarts and
migration content) with standardized card layouts and updated link
destinations.
* **Component Updates**
* Standardized “GlassPanel” styling (background toggle removed) and
simplified icon-based panels; added an `IconLinkButton` for action
tiles; updated authentication provider grids to use the shared tile UI.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
94 lines
3.6 KiB
TypeScript
94 lines
3.6 KiB
TypeScript
'use client'
|
|
|
|
import { safeHistoryReplaceState } from '~/lib/historyUtils'
|
|
import { useEffect, useId, useReducer, useRef } from 'react'
|
|
import { Dialog, DialogContent, DialogHeader, DialogSection, Heading } from 'ui'
|
|
|
|
import { PhoneLoginsItems } from '../Navigation/NavigationMenu/NavigationMenu.constants'
|
|
import MessageBird from './MessageBirdConfig.mdx'
|
|
import TextLocal from './TextLocalConfig.mdx'
|
|
import Twilio from './TwilioConfig.mdx'
|
|
import Vonage from './VonageConfig.mdx'
|
|
import { IconLinkButton, IconLinkImage } from '@/features/ui/IconLink'
|
|
|
|
const reducer = (_, action: (typeof PhoneLoginsItems)[number] | undefined) => {
|
|
const url = new URL(document.location.href)
|
|
if (action) {
|
|
url.searchParams.set('showSmsProvider', encodeURIComponent(action.name))
|
|
} else {
|
|
url.searchParams.delete('showSmsProvider')
|
|
}
|
|
safeHistoryReplaceState(url.toString())
|
|
return action
|
|
}
|
|
|
|
const AuthSmsProviderConfig = () => {
|
|
const [selectedProvider, setSelectedProvider] = useReducer(reducer, undefined)
|
|
const dialogId = useId()
|
|
const dialogTitleId = useId()
|
|
|
|
useEffect(() => {
|
|
const providerName = new URLSearchParams(document.location.search ?? '').get('showSmsProvider')
|
|
if (!providerName) return
|
|
|
|
const provider = PhoneLoginsItems.find((item) => item.name === decodeURIComponent(providerName))
|
|
if (provider) setSelectedProvider(provider)
|
|
}, [])
|
|
|
|
const headingRef = useRef<HTMLHeadingElement>(null)
|
|
|
|
return (
|
|
<>
|
|
<section aria-labelledby="sms-provider-configuration">
|
|
<h3 className="sr-only" id="sms-provider-configuration">
|
|
Configuring SMS Providers
|
|
</h3>
|
|
<ul className="grid grid-cols-12 gap-6 not-prose py-8">
|
|
{PhoneLoginsItems.map((provider) => (
|
|
<li key={provider.name} className="col-span-12 sm:col-span-6 xl:col-span-3">
|
|
<IconLinkButton
|
|
title={provider.name}
|
|
icon={<IconLinkImage path={provider.icon} hasLightIcon={provider.hasLightIcon} />}
|
|
aria-haspopup="dialog"
|
|
aria-expanded={selectedProvider?.name === provider.name}
|
|
aria-controls={selectedProvider?.name === provider.name ? dialogId : undefined}
|
|
onClick={() => setSelectedProvider(provider)}
|
|
/>
|
|
</li>
|
|
))}
|
|
</ul>
|
|
</section>
|
|
<Dialog
|
|
open={!!selectedProvider}
|
|
onOpenChange={(open) => !open && setSelectedProvider(undefined)}
|
|
>
|
|
{selectedProvider && (
|
|
<DialogContent
|
|
id={dialogId}
|
|
className="w-[min(90vw,80ch)]! max-w-[min(90vw,80ch)]! max-h-[90dvh]! prose overflow-auto"
|
|
aria-labelledby={dialogTitleId}
|
|
onOpenAutoFocus={(evt) => {
|
|
evt.preventDefault()
|
|
headingRef.current?.focus()
|
|
}}
|
|
>
|
|
<DialogHeader className="pb-0 [&>h3]:m-0! [&>h3>a]:hidden! [&>h3:focus-visible]:outline-hidden">
|
|
<Heading tag="h3" id={dialogTitleId} ref={headingRef} tabIndex={-1}>
|
|
{selectedProvider.name}
|
|
</Heading>
|
|
</DialogHeader>
|
|
<DialogSection className="*:first:mt-0">
|
|
{selectedProvider.name.toLowerCase().includes('messagebird') && <MessageBird />}
|
|
{selectedProvider.name.toLowerCase().includes('twilio') && <Twilio />}
|
|
{selectedProvider.name.toLowerCase().includes('vonage') && <Vonage />}
|
|
{selectedProvider.name.toLowerCase().includes('textlocal') && <TextLocal />}
|
|
</DialogSection>
|
|
</DialogContent>
|
|
)}
|
|
</Dialog>
|
|
</>
|
|
)
|
|
}
|
|
|
|
export default AuthSmsProviderConfig
|