upstream-tldraw/apps/docs/next.config.js

/** @type {import('next').NextConfig} */

function resolveAssetOrigin() {
	const explicit =
		process.env.ASSET_PREFIX?.trim() ||
		process.env.NEXT_PUBLIC_ASSET_PREFIX?.trim() ||
		process.env.NEXT_PUBLIC_DOCS_ASSET_PREFIX?.trim()
	if (explicit) return explicit.replace(/\/$/, '')

	const vercelUrl = process.env.VERCEL_URL?.trim() || process.env.NEXT_PUBLIC_VERCEL_URL?.trim()
	if (vercelUrl) {
		const host = vercelUrl.replace(/^https?:\/\//, '')
		return `https://${host}`
	}

	return undefined
}

const nextConfig = {
	reactStrictMode: true,
	assetPrefix: resolveAssetOrigin(),
	experimental: {
		scrollRestoration: true,
	},
	images: {
		remotePatterns: [
			{
				protocol: 'https',
				hostname: 'substackcdn.com',
			},
			{
				protocol: 'https',
				hostname: 'i.pravatar.cc',
			},
			{
				protocol: 'https',
				hostname: 'i.imgur.com',
			},
		],
	},
	async redirects() {
		return [
			{
				// For backwards compatibility with old links
				source: '/:sectionId/ucg/:articleId',
				destination: '/:sectionId/:articleId',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/docs/introduction',
				destination: '/quick-start',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/introduction',
				destination: '/quick-start',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/docs/installation',
				destination: '/installation',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/docs/usage',
				destination: '/installation',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/usage',
				destination: '/installation',
				permanent: true,
			},
			{
				// To reflect that these are at the top level of the sidebar
				source: '/getting-started/:childId',
				destination: '/:childId',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				// (This is a page that we referred people to quite often)
				source: '/gen/editor/Editor-class',
				destination: '/reference/editor/Editor',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				// (This is a page that we referred people to quite often)
				source: '/gen/editor/ShapeUtil-class',
				destination: '/reference/editor/ShapeUtil',
				permanent: true,
			},
			{
				// For backwards compatibility with old links
				source: '/gen/:slug*',
				destination: '/reference/:slug*',
				permanent: true,
			},
			{
				// For backwards compatibility with renamed examples
				source: '/examples/basic/state-store',
				destination: '/examples/signals',
				permanent: true,
			},
			{
				// For backwards compatibility with old examples links
				source: '/examples/:categoryId/:articleId',
				destination: '/examples/:articleId',
				permanent: true,
			},
			{
				// For backwards compatibility with old examples links
				source: '/examples/:categoryId/:categoryId2/:articleId',
				destination: '/examples/:articleId',
				permanent: true,
			},
			{
				// For backwards compatibility with renamed examples
				source: '/examples/state-store',
				destination: '/examples/signals',
				permanent: true,
			},
			{
				// For backwards compatibility with renamed examples
				source: '/examples/basic/peristence-key',
				destination: '/examples/persistence-key',
				permanent: true,
			},
			{
				source: '/examples',
				destination: '/examples/basic',
				permanent: true,
			},
			{
				source: '/reference',
				destination: '/reference/editor/Editor',
				permanent: true,
			},
			{
				source: '/docs',
				destination: '/quick-start',
				permanent: true,
			},
			{
				source: '/releases-versioning',
				destination: '/releases',
				permanent: true,
			},
			{
				source: '/jobs',
				destination: '/careers',
				permanent: true,
			},
			{
				source: '/legal/cla',
				destination: '/legal/contributor-license-agreement',
				permanent: true,
			},
			{
				source: '/legal/trademarks',
				destination: '/legal/trademark-guidelines',
				permanent: true,
			},
			{
				source: '/codewithjason',
				destination:
					'/?utm_source=codewithjason&utm_medium=podcast&utm_campaign=steve_codewithjason_2025',
				permanent: true,
			},
			{
				source: '/diveclub',
				destination: '/?utm_source=diveclub&utm_medium=podcast&utm_campaign=steve_diveclub_2025',
				permanent: true,
			},
			{
				source: '/shoptalk',
				destination: '/?utm_source=shoptalk&utm_medium=podcast&utm_campaign=steve_shoptalk_2025',
				permanent: true,
			},
			{
				source: '/hanselminutes',
				destination:
					'/?utm_source=hanselminutes&utm_medium=paid_podcast&utm_campaign=ad_hanselminutes_2025',
				permanent: true,
			},
			{
				source: '/mostlytechnical',
				destination:
					'/?utm_source=mostlytechnical&utm_medium=paid_podcast&utm_campaign=ad_mostlytechnical_2025',
				permanent: true,
			},
			{
				source: '/starter-kits',
				destination: '/starter-kits/overview',
				permanent: true,
			},
			{
				source: '/discord',
				destination: 'https://discord.com/invite/s4FXZ6fppJ',
				permanent: false,
			},
		]
	},
	async rewrites() {
		return {
			// Canonical top-level URLs (/quick-start, …) are not in the content DB; articles
			// live under /getting-started/*. Redirects send /getting-started/:id → /:id;
			// these rewrites serve the article without a second hop (avoids /quick-start 404).
			beforeFiles: [
				{ source: '/quick-start', destination: '/getting-started/quick-start' },
				{ source: '/installation', destination: '/getting-started/installation' },
				{ source: '/releases', destination: '/getting-started/releases' },
			],
		}
	},
}

module.exports = nextConfig