Files
supabase/apps/docs/data/content-listings/index.ts
T
Danny White c0f1ef51fb feat(docs): migrate resources and getting-started to ContentListings (#48517)
## What kind of change does this PR introduce?

Docs update / follow-up to #48379.

## What is the current behavior?

`/guides/resources` and `/guides/getting-started` hand-roll `GlassPanel`
grids in MDX. They look like ContentListings cards after the chrome PR,
but they do not use the shared data files, so they miss PostHog
`docs_content_listing_clicked` telemetry and the CONTRIBUTING
contribution path.

## What is the new behavior?

Those pages use `<ContentListings id="…" />` backed by
`resources.data.ts` and `getting-started.data.ts`, same pattern as
storage.

- Section-level `$Show` wrappers stay for framework / web / mobile
blocks
- Nimbus stays a `$Partial` behind `$Show`
- New optional per-item `feature` field gates SDK links (e.g. Flutter /
Swift / Kotlin) without splitting whole sections
- CONTRIBUTING notes when to use `feature` vs a partial-level `$Show`

## To test

Compare the following against `master`:

-
[Resources](https://docs-git-dnywh-docs-content-listings-resources-239158-supabase.vercel.app/docs/guides/resources):
overview, migrate, and postgres grids; icons in light/dark
- [Getting
started](https://docs-git-dnywh-docs-content-listings-resources-239158-supabase.vercel.app/docs/guides/getting-started):
overview, use cases, framework quickstarts, web demos, mobile tutorials;
nimbus partial when enabled
- Click a card and confirm `docs_content_listing_clicked` fires with the
expected `listingId`

Everything should look and feel the same. It’s just that we’re using
`ContentListings` instead of `GlassPanel` grids.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Added centralized Getting Started and Resources content listings,
including quickstarts, demos, tutorials, migration guides, and Postgres
resources.
- Added feature-based visibility controls for individual content listing
items.

- **Improvements**
- Disabled content is now automatically hidden from documentation pages
and generated Markdown.
  - Pages and sections with no available content are omitted entirely.
  - External documentation links are more secure.
- Updated contribution guidance with instructions and examples for
feature flags.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-08-03 00:52:44 +00:00

75 lines
2.3 KiB
TypeScript

import type { ContentListingGroup } from '~/lib/content-listings.schema'
import { aiToolsBuildingIntoApp, aiToolsSupportedAgents } from './ai-tools.data'
import { authGetStarted, authNextSteps, authPricing } from './auth.data'
import { databaseGetStarted, databaseNextSteps } from './database.data'
import {
functionsExamplesAiMedia,
functionsExamplesMessaging,
functionsExamplesOperations,
functionsExamplesSupabase,
functionsExamplesWebhooksPayments,
functionsGetStarted,
} from './functions.data'
import {
gettingStartedFrameworkQuickstarts,
gettingStartedMobileTutorials,
gettingStartedOverview,
gettingStartedUseCases,
gettingStartedWebAppDemos,
} from './getting-started.data'
import { logDrainsDestinations } from './log-drains.data'
import { realtimeExamples, realtimeGetStarted, realtimeResources } from './realtime.data'
import { resourcesMigrate, resourcesOverview, resourcesPostgres } from './resources.data'
import {
selfHostingCommunity,
selfHostingGetHelp,
selfHostingGetStarted,
selfHostingResolveIssues,
selfHostingShareExperience,
} from './self-hosting.data'
import { storageExamples, storageGetStarted, storageResources } from './storage.data'
import { telemetryDebugging, telemetryMonitoring } from './telemetry.data'
const ALL_GROUPS: readonly ContentListingGroup[] = [
aiToolsSupportedAgents,
aiToolsBuildingIntoApp,
authGetStarted,
authPricing,
authNextSteps,
databaseGetStarted,
databaseNextSteps,
functionsGetStarted,
functionsExamplesSupabase,
functionsExamplesWebhooksPayments,
functionsExamplesAiMedia,
functionsExamplesMessaging,
functionsExamplesOperations,
gettingStartedOverview,
gettingStartedUseCases,
gettingStartedFrameworkQuickstarts,
gettingStartedWebAppDemos,
gettingStartedMobileTutorials,
logDrainsDestinations,
realtimeGetStarted,
realtimeExamples,
realtimeResources,
resourcesOverview,
resourcesMigrate,
resourcesPostgres,
selfHostingGetStarted,
selfHostingCommunity,
selfHostingResolveIssues,
selfHostingGetHelp,
selfHostingShareExperience,
storageGetStarted,
storageExamples,
storageResources,
telemetryDebugging,
telemetryMonitoring,
]
export const CONTENT_LISTINGS: Readonly<Record<string, ContentListingGroup>> = Object.fromEntries(
ALL_GROUPS.map((group) => [group.id, group])
)