docs(next): add Pages Router quickstart#350
Merged
Merged
Conversation
- New tutorials/quickstart-pages-router page: withGTServerSideProps around getServerSideProps, GTProvider wiring in _app.tsx via WithGTServerSideProps, local translation loading, LocaleSelector, env vars, and deployment - Link to it from the App Router quickstart and add it to the sidebar
ErnestM1234
enabled auto-merge (squash)
July 10, 2026 04:47
logflash
approved these changes
Jul 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a Pages Router quickstart for
gt-nextv11 alongside the existing App Router quickstart (this was an open follow-up from the Odysseus docs work — the Pages Router helpers were previously undocumented):next/tutorials/quickstart-pages-router— full setup guide:withGTConfig,gt.config.json, auto-detectedloadTranslations.ts, wrappinggetServerSidePropswithwithGTServerSideProps(resolves the locale from thegeneraltranslation.localecookie, falling back toAccept-Language, and snapshots translations per request), and wiring<GTProvider locale translations>in_app.tsxtyped withWithGTServerSideProps.withGTServerSideProps()for pages without their own server-side props, redirect/notFound passthrough, and why there's nogetStaticPropsequivalent.Content is cross-checked against the
next-pages-routerapp ingt-test-appsand the v11gt-nextsources (withGTServerSidePropsinjectslocale,translations, and an internalenableI18nflag; the type isWithGTServerSideProps<Props>; both export from thegt-nextroot).Validation
npx tsx scripts/validate-links.tspassespnpm build:contentpasses; the new page appears in the prerender manifestNote: the one-callout edit to
next/index.mdxmay need a trivial rebase if #340 (which rewrites that page) merges first.