Files
supabase/apps/docs/data/content-listings/resources.data.ts
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

132 lines
4.2 KiB
TypeScript

import type { ContentListingGroup } from '~/lib/content-listings.schema'
export const resourcesOverview: ContentListingGroup = {
id: 'resources-overview',
type: 'grid',
items: [
{
title: 'Examples',
href: '/guides/getting-started',
description: 'Official GitHub examples, curated content from the community, and more.',
},
{
title: 'Glossary',
href: '/guides/resources/glossary',
description: 'Definitions for terminology and acronyms used in the Supabase documentation.',
},
],
}
export const resourcesMigrate: ContentListingGroup = {
id: 'resources-migrate',
heading: 'Migrate to Supabase',
headingLevel: 'h3',
type: 'grid',
items: [
{
title: 'Auth0',
href: '/guides/platform/migrating-to-supabase/auth0',
icon: '/docs/img/icons/auth0-icon',
hasLightIcon: true,
description: 'Move your auth users from Auth0 to a Supabase project.',
},
{
title: 'Firebase Auth',
href: '/guides/platform/migrating-to-supabase/firebase-auth',
icon: '/docs/img/icons/firebase-icon',
hasLightIcon: false,
description: 'Move your auth users from a Firebase project to a Supabase project.',
},
{
title: 'Firestore Data',
href: '/guides/platform/migrating-to-supabase/firestore-data',
icon: '/docs/img/icons/firebase-icon',
hasLightIcon: false,
description: 'Migrate the contents of a Firestore collection to a single Postgres table.',
},
{
title: 'Firebase Storage',
href: '/guides/platform/migrating-to-supabase/firebase-storage',
icon: '/docs/img/icons/firebase-icon',
hasLightIcon: false,
description: 'Convert your Firebase Storage files to Supabase Storage.',
},
{
title: 'Heroku',
href: '/guides/platform/migrating-to-supabase/heroku',
icon: '/docs/img/icons/heroku-icon',
hasLightIcon: false,
description: 'Migrate your Heroku Postgres database to Supabase.',
},
{
title: 'Render',
href: '/guides/platform/migrating-to-supabase/render',
icon: '/docs/img/icons/render-icon',
hasLightIcon: false,
description: 'Migrate your Render Postgres database to Supabase.',
},
{
title: 'Amazon RDS',
href: '/guides/platform/migrating-to-supabase/amazon-rds',
icon: '/docs/img/icons/aws-rds-icon',
hasLightIcon: false,
description: 'Migrate your Amazon RDS database to Supabase.',
},
{
title: 'Postgres',
href: '/guides/platform/migrating-to-supabase/postgres',
icon: '/docs/img/icons/postgres-icon',
hasLightIcon: false,
description: 'Migrate your Postgres database to Supabase.',
},
{
title: 'MySQL',
href: '/guides/platform/migrating-to-supabase/mysql',
icon: '/docs/img/icons/mysql-icon',
hasLightIcon: false,
description: 'Migrate your MySQL database to Supabase.',
},
{
title: 'Microsoft SQL Server',
href: '/guides/platform/migrating-to-supabase/mssql',
icon: '/docs/img/icons/mssql-icon',
hasLightIcon: false,
description: 'Migrate your Microsoft SQL Server database to Supabase.',
},
],
}
export const resourcesPostgres: ContentListingGroup = {
id: 'resources-postgres',
heading: 'Postgres resources',
headingLevel: 'h3',
type: 'grid',
items: [
{
title: 'Managing Indexes',
href: '/guides/database/postgres/indexes',
description: 'Improve query performance using various index types in Postgres.',
},
{
title: 'Cascade Deletes',
href: '/guides/database/postgres/cascade-deletes',
description: 'Understand the types of foreign key constraint deletes.',
},
{
title: 'Drop all tables in schema',
href: '/guides/database/postgres/dropping-all-tables-in-schema',
description: 'Delete all tables in a given schema.',
},
{
title: 'Select first row per group',
href: '/guides/database/postgres/first-row-in-group',
description: 'Retrieve the first row in each distinct group.',
},
{
title: 'Print Postgres version',
href: '/guides/database/postgres/which-version-of-postgres',
description: 'Find out which version of Postgres you are running.',
},
],
}