snapshot of https://github.com/tldraw/tldraw.git (main, 2026-09-23; blobs > 131072B omitted)

apps/docs/next.config.js

@@ -0,0 +1,224 @@
+/** @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