Skip to content

Conversation

@SarahSoutoul
Copy link
Contributor

@SarahSoutoul SarahSoutoul commented Jan 26, 2026

🔎 Previews:

What does this solve?

This PR is part of the wider Docs IA V2 project aiming at making our docs more consistent and offering a better UX experience for our users. This particular PR revisits what belongs under the Next steps sections across our Getting started guides. The goal was to have a cleaner/clearer Next steps section at the bottom of each Quickstart/Getting Started guide that calls out the main things you'd likely want to do next.

While the focus was on Getting Started guides, I looked at the Next steps sections across our docs to make it all consistent, including guides under the Organization tab or the Custom sign-in-or-up guides. See details below.

What changed?

  • Added a Next steps section to any Getting Started guide that didn't have any (Fastify, Go, JS Backend SDK)
  • Made the Next steps sections consistent across the following guides:
    • Getting started guides
    • Custom Sign up / Sign in or up guides
    • All the guides under the Organizations tab
    • The firebase integration guide
    • Guides under Expo web support
    • Declarative mode + spa mode guides
  • Made the intro paragraphs of each Next steps section consistent and align with the cards under
  • Made choices on the flow / thread of what needs to be put in Next steps. See thought process below.
  • Added a partial for the Next steps section used in all of Expo web support guides

The thought process that went into choosing what goes in each Next steps section

  • For most SDKs (frontend), my choices were the following:

    • First, I've chosen to have Prebuilt components + customization cards given that would be the natural thread a user follows after creating their first app.
    • Then, I have put any cards linking to a custom guide depending on the SDK, with the most widely used one being the Create a custom sign-in-or-up page guide.
    • Then, I have put the Protect content and read user data guide for any SDKs it applies to. For others, it would be instead any Protect routes using... guide.
    • Then, for any SDK it applies to, the Get started with Organizations guide. For SDKs to which it doesn't apply, I've put any other guide that is related to the SDK.
    • Finally, all sections finish off with a link to the SDK reference.
  • For native SDKs like Android and iOS, the Next steps follows this thread:

    • Link to the Views reference
    • Link to customizing those views
    • Link to a "Sign in with X" guide
    • Link to the SDK reference
  • For Backend SDKs like Fastify, Express, etc, the Next steps consists of links to resources to protect routes, and a link to the SDK reference.

  • The Chrome Extension SDK is prob the most different one out of all of them given its very specific guides.

Deadline

When do you need this PR reviewed/shipped by?
Optional - uncomment if needed. If not provided, we will prioritize it ourselves.
-->

@SarahSoutoul SarahSoutoul self-assigned this Jan 26, 2026
@vercel
Copy link

vercel bot commented Jan 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Jan 29, 2026 10:32pm

Request Review

@SarahSoutoul SarahSoutoul changed the title Revamp of "Next steps" section at the bottom of each Quickstart/Getting Started guide (WIP) Revamp of "Next steps" section at the bottom of each Quickstart/Getting Started guide Jan 26, 2026
@SarahSoutoul SarahSoutoul changed the title (WIP) Revamp of "Next steps" section at the bottom of each Quickstart/Getting Started guide Revamp of "Next steps" section at the bottom of each Quickstart/Getting Started guide Jan 27, 2026
@SarahSoutoul SarahSoutoul marked this pull request as ready for review January 27, 2026 16:29
@SarahSoutoul SarahSoutoul requested a review from a team as a code owner January 27, 2026 16:29
Comment on lines 311 to 312
- [Prebuilt components](/docs/reference/components/overview)
- Learn how to quickly add authentication to your app using Clerk's suite of components.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clerk expo doesn't support prebuilt components, unless they're using web (but it's more likely clerk user's using the expo sdk are using it for native development). i'd link to the custom flows instead! this means that the next card, customization & localization, probably isn't necessary as well.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<Cards>
- [Protect API routes using clerkMiddleware()](/docs/reference/nuxt/clerk-middleware)
- Learn how to protect specific API routes from unauthenticated users.
- [Prebuilt components](/docs/reference/components/overview)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for vue and nuxt, they're called composables!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@alexisintech Aren't composables the hooks?

Screenshot 2026-01-29 at 4 24 44 pm

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lmao i'm TRIPPIN @SarahSoutoul


- [Client-side helpers](/docs/reference/nuxt/overview#client-side-helpers)
- Learn more about Nuxt client-side helpers and how to use them.
- [Client-side helpers (composables)](/docs/reference/nuxt/overview#client-side-helpers)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a duplicate of the first card (prebuilt components)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not tho? They're linking to two diff things? @alexisintech

Copy link
Member

@alexisintech alexisintech Jan 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah i was confused btwn composables and components :P

@@ -112,7 +112,7 @@ Learn more about Clerk components, how to customize them, and how to use Clerk's

<Cards>
- [Prebuilt components](/docs/reference/components/overview)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comments that i left for nuxt! swap components for composables

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Copy link
Member

@alexisintech alexisintech left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great work here friend 👏 🐐

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.

3 participants