Skip to content

fix(dev): print i18n info only once to avoid noisy logs #4810

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Golenspade wants to merge 2 commits into
base: main
Choose a base branch
from
Open

fix(dev): print i18n info only once to avoid noisy logs #4810

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bc00bac
fix(dev): print i18n info only once to avoid noisy logs
Golenspade Oct 2, 2025
acfb028
chore: add changeset for i18n log-once fix
Golenspade Oct 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/fix-i18n-log-once.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"nextra": patch
---

fix(dev): print i18n info only once to avoid noisy logs
13 changes: 12 additions & 1 deletion packages/nextra/src/server/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,17 @@ const LOADER_PATH = path.join(FILENAME, '..', '..', '..', 'loader.cjs')

const SEP = path.sep === '/' ? '/' : '\\\\'

// Print-once helper for noisy dev logs (i18n tip)
const I18N_LOG_ONCE_KEY = Symbol.for('nextra.i18n.log.once')
function logI18nOnce(msg: string) {
if (process.env.NODE_ENV === 'production') return
const g = globalThis as any
if (!g[I18N_LOG_ONCE_KEY]) {
logger.info(msg)
g[I18N_LOG_ONCE_KEY] = true
}
}

const GET_PAGE_MAP_PATH = '/nextra/dist/server/page-map/get.js'

const PAGE_MAP_PLACEHOLDER_PATH = '/nextra/dist/server/page-map/placeholder.js'
Expand Down Expand Up @@ -101,7 +112,7 @@ const nextra = (nextraConfig: NextraConfig) => {
return function withNextra(nextConfig: NextConfig = {}): NextConfig {
const { locales, defaultLocale } = nextConfig.i18n || {}
if (locales) {
logger.info(
logI18nOnce(
'You have Next.js i18n enabled, read here https://nextjs.org/docs/app/building-your-application/routing/internationalization for the docs.'
)
}
Expand Down