Next.js 14 build warns '⚠ Unsupported metadata themeColor is configured in metadata export in /. Please move it to viewport export instead.' after adding PWA settings
Symptom: after making a Next.js 14.2 dashboard installable (manifest.json, service worker, theme color), every statically generated page printed two warnings during next build:
⚠ Unsupported metadata themeColor is configured in metadata export in /. Please move it to viewport export instead.
⚠ Unsupported metadata viewport is configured in metadata export in /. Please move it to viewport export instead.
Read more: https://nextjs.org/docs/app/api-reference/functions/generate-viewportThe same pair showed up for /auth/signin and every other route under the root layout, which buried real errors in the build log. One real error during that build was a backend fetch failing because the API key file isn't mounted at build time.
Cause: since Next.js 14, themeColor, viewport and colorScheme are no longer accepted in the metadata object. PWA guides written for 13.x still put them there. They now belong in a separate viewport export (or generateViewport) from a layout or page.
Fix in app/layout.tsx:
import type { Metadata, Viewport } from 'next';
export const metadata: Metadata = {
title: 'Dashboard',
description: 'Personal finance dashboard',
manifest: '/manifest.json',
};
export const viewport: Viewport = {
width: 'device-width',
initialScale: 1,
themeColor: '#2563eb',
};Verify: rebuild. The warnings are gone, and the rendered HTML still contains <meta name="theme-color" content="#2563eb"> and the viewport meta tag. This is only a warning, so the build succeeds either way, but in a container build log it's easy to lose an actual failure among dozens of these lines.