create-adr-app 0.0.0-stage → 0.1.0

package/template/dictionaries/en.json

@@ -0,0 +1,280 @@
+{
+  "contextTitle": "Context and Problem Statement",
+  "description": "We want to record architectural decisions made in this project.",
+  "companies": "Companies",
+  "companies.subtitle": "Our companies",
+  "services": "Services",
+  "services.subtitle": "Explore our services",
+  "products": "Products",
+  "products.subtitle": "Explore our breakthrough technologies",
+  "applications": "Applications",
+  "applications.subtitle": "Explore our applications",
+
+  "mdx.page.title": "This is a test title text",
+  "mdx.page.subtitle": "Subtitle text for MDX in en locale",
+  "some.other.key": "Testing MDX with translations",
+
+  "glossary": "Glossary",
+  "glossary.subtitle": "Key terms and concepts explained",
+  "glossary.searchPlaceholder": "Search terms or definitions...",
+  "glossary.noTermsFound": "No terms found",
+  "glossary.lastUpdated": "Last updated • May 2026",
+  "glossary.term.ADR": "ADR (Architecture Decision Record)",
+  "glossary.term.nanoassembler": "Nanoassembler",
+  "glossary.term.starship": "Starship",
+  "glossary.term.optimus": "Optimus",
+  "glossary.term.neuralink": "Neuralink",
+  "glossary.term.fusion": "Fusion",
+  "glossary.term.terraforming": "Terraforming",
+  "glossary.definition.ADR": "Architecture Decision Record – a short document that captures an important architectural decision, its context, and trade-offs.",
+  "glossary.definition.nanoassembler": "A hypothetical molecular machine capable of building complex structures atom-by-atom with atomic precision.",
+  "glossary.definition.starship": "SpaceX’s fully reusable spacecraft designed for interplanetary travel and rapid Earth-to-Earth transport.",
+  "glossary.definition.optimus": "Tesla’s humanoid robot designed to perform useful tasks in factories, homes, and beyond.",
+  "glossary.definition.neuralink": "Brain-computer interface technology that aims to enable direct communication between the human brain and computers.",
+  "glossary.definition.fusion": "A nuclear reaction in which two light atomic nuclei combine to form a heavier nucleus, releasing enormous energy.",
+  "glossary.definition.terraforming": "The hypothetical process of deliberately modifying a planet’s atmosphere, temperature, and ecology to make it habitable for humans.",
+  "glossary.term.commoditization": "Commoditization",
+  "glossary.term.commodity": "Commodity",
+  "glossary.term.fungibility": "Fungibility",
+  "glossary.definition.commoditization": "The process by which goods that have economic value and are distinguishable by attributes (uniqueness or brand) become simple commodities in the eyes of the market or consumers, shifting competition from differentiated features to price alone.",
+  "glossary.definition.commodity": "An economic good or resource that is fully interchangeable with others of the same type, with no regard to who produced it and typically traded on price.",
+  "glossary.definition.fungibility": "The property of a good, asset, or currency whose individual units are completely interchangeable and indistinguishable from one another.",
+  "glossary.domain.general": "General",
+  "glossary.domain.llm-training": "LLM Training",
+
+  "title": "Architecture Decision Records",
+  "welcome": "Welcome to the Architecture Decision Records of the R&D Center. Here you can find Architecture Decision Records (ADR) of the project.",
+  "definition-title": "Definition and purpose",
+  "definition-description": "An Architecture Decision is a design choice that addresses a functional or non-functional requirement that is architecturally significant. An Architecture Decision Record (ADR) describes a single Architecture Decision; the collection of ADRs created and maintained in a project constitutes its decision log.",
+  "definition-description-2": "You can become familiar with the design of the project by reading its decision log in chronological order. Moreover, maintaining this documentation aims at:",
+  "purpose-1": "Making reasoning about design easily accessible",
+  "purpose-2": "Making better design choices easier",
+  "purpose-3": "Improving and speeding up the onboarding of new team members",
+  "purpose-4": "Avoiding blind acceptance/reversal of a past decision",
+  "purpose-5": "Formalizing the decision process of the team",
+  "purpose-6": "Serving as a valuable input for AI for automation purposes",
+
+  "category.rd-center": "R&D Center ADRs",
+  "category.medium-size-reusable-rocket": "Medium-size Reusable Rocket ADRs",
+  "category.large-size-reusable-rocket": "Large-size Reusable Rocket ADRs",
+  "category.spaceport-infra": "Spaceport Infra ADRs",
+  "category.planet-habitation": "Planet Habitation ADRs",
+  "category.satellite-internet": "Satellite Internet ADRs",
+  "category.warp-drive": "Warp Drive ADRs",
+  "category.electric-cars-and-robots": "Electric Cars & Robots ADRs",
+  "category.ai-datacenter": "AI Datacenter ADRs",
+  "category.neurotechnology": "Neurotechnology ADRs",
+
+  "status.draft": "Draft",
+  "status.proposed": "Proposed",
+  "status.accepted": "Accepted",
+  "status.rejected": "Rejected",
+  "status.deprecated": "Deprecated",
+  "status.superseded": "Superseded",
+  "category.decisions": "Architecture Decision Records",
+
+  "neuralink.title": "Neuralink",
+  "neuralink.description": "This is the Neuralink page.",
+  "spacex.title": "SpaceX",
+  "spacex.description": "This is the SpaceX page.",
+  "tesla.title": "Tesla",
+  "tesla.description": "This is the Tesla page.",
+  "xai.title": "xAI",
+  "xai.description": "This is the xAI page.",
+
+  "3d-printer-for-starships.title": "3D Printer for Starships",
+  "3d-printer-for-starships.description": "This is the 3D Printer for Starships page.",
+  "alternative-hardware-for-ai-training.title": "Alternative Hardware for AI Training",
+  "alternative-hardware-for-ai-training.description": "This is the Alternative Hardware for AI Training page.",
+  "automated-design-manufacturing-pipeline.title": "Automated Design Manufacturing Pipeline",
+  "automated-design-manufacturing-pipeline.description": "This is the Automated Design Manufacturing Pipeline page.",
+  "engineering-simulation-tool.title": "Engineering Simulation Tool",
+  "engineering-simulation-tool.description": "This is the Engineering Simulation Tool page.",
+  "faster-factories.title": "Faster Factories",
+  "faster-factories.description": "This is the Faster Factories page.",
+  "fusion-power-plant.title": "Fusion Power Plant",
+  "fusion-power-plant.description": "This is the Fusion Power Plant page.",
+  "fusion-starship.title": "Fusion Starship",
+  "fusion-starship.description": "This is the Fusion Starship page.",
+  "hardware.title": "Hardware",
+  "hardware.description": "This is the Hardware page.",
+  "instantly-reusable-launchpad.title": "Instantly Reusable Launchpad",
+  "instantly-reusable-launchpad.description": "This is the Instantly Reusable Launchpad page.",
+  "mass-driver.title": "Mass Driver",
+  "mass-driver.description": "This is the Mass Driver page.",
+  "nano-assembled-cybercab.title": "Nano-Assembled Cybercab",
+  "nano-assembled-cybercab.description": "This is the Nano-Assembled Cybercab page.",
+  "nano-assembled-mechazilla.title": "Nano-Assembled Mechazilla",
+  "nano-assembled-mechazilla.description": "This is the Nano-Assembled Mechazilla page.",
+  "nano-assembled-optimus.title": "Nano-Assembled Optimus",
+  "nano-assembled-optimus.description": "This is the Nano-Assembled Optimus page.",
+  "nano-assembled-orbital-heat-shield.title": "Nano-Assembled Orbital Heat Shield",
+  "nano-assembled-orbital-heat-shield.description": "This is the Nano-Assembled Orbital Heat Shield page.",
+  "nano-assembled-semi.title": "Nano-Assembled Semi",
+  "nano-assembled-semi.description": "This is the Nano-Assembled Semi page.",
+  "nano-assembled-starlink.title": "Nano-Assembled Starlink",
+  "nano-assembled-starlink.description": "This is the Nano-Assembled Starlink page.",
+  "nano-assembled-starship.title": "Nano-Assembled Starship",
+  "nano-assembled-starship.description": "This is the Nano-Assembled Starship page.",
+  "nano-assembler.title": "Nano-Assembler",
+  "nano-assembler.description": "This is the Nano-Assembler page.",
+  "neuromorphic-computing.title": "Neuromorphic Computing",
+  "neuromorphic-computing.description": "This is the Neuromorphic Computing page.",
+  "perspective-neuralink-bcis.title": "Perspective Neuralink BCIs",
+  "perspective-neuralink-bcis.description": "This is the Perspective Neuralink BCIs page.",
+  "photonic-computing.title": "Photonic Computing",
+  "photonic-computing.description": "This is the Photonic Computing page.",
+  "quantum-computing.title": "Quantum Computing",
+  "quantum-computing.description": "This is the Quantum Computing page.",
+  "quantum-data-centers-in-space.title": "Quantum Data Centers in Space",
+  "quantum-data-centers-in-space.description": "This is the Quantum Data Centers in Space page.",
+  "regular-and-ai-data-centers-in-space.title": "Regular & AI Data Centers in Space",
+  "regular-and-ai-data-centers-in-space.description": "This is the Regular & AI Data Centers in Space page.",
+  "smart-starbase.title": "Smart Starbase",
+  "smart-starbase.description": "This is the Smart Starbase page.",
+  "warp-drive.title": "Warp Drive",
+  "warp-drive.description": "This is the Warp Drive page.",
+
+  "3d-printing.title": "3D Printing",
+  "3d-printing.description": "This is the 3D Printing page.",
+  "3d-printing-starships.title": "3D Printing Starships",
+  "3d-printing-starships.description": "This is the 3D Printing Starships page.",
+  "air-separation.title": "Air Separation",
+  "air-separation.description": "This is the Air Separation page.",
+  "automation.title": "Automation",
+  "automation.description": "This is the Automation page.",
+  "compressing-mars-terraforming.title": "Compressing Mars Terraforming to 10 years",
+  "compressing-mars-terraforming.description": "This is the Compressing Mars Terraforming to 10 years page.",
+  "direct-binary-code-generation.title": "Direct Binary Code Generation",
+  "direct-binary-code-generation.description": "This is the Direct Binary Code Generation page.",
+  "falcon-9-heavy-nano-assembly.title": "Falcon 9 & Heavy Nano-Assembly",
+  "falcon-9-heavy-nano-assembly.description": "This is the Falcon 9 & Heavy Nano-Assembly page.",
+  "hardware-development-services.title": "Hardware Development Services",
+  "hardware-development-services.description": "This is the Hardware Development Services page.",
+  "healing-autism.title": "Healing Autism",
+  "healing-autism.description": "This is the Healing Autism page.",
+  "nano-assembled-ground-works.title": "Nano-Assembled Ground Works",
+  "nano-assembled-ground-works.description": "This is the Nano-Assembled Ground Works page.",
+  "nano-assembly.title": "Nano-assembly",
+  "nano-assembly.description": "This is the Nano-assembly page.",
+  "nanoassembly-boosted-spacex.title": "Nanoassembly-boosted SpaceX",
+  "nanoassembly-boosted-spacex.description": "This is the Nanoassembly-boosted SpaceX page.",
+  "overcoming-serial-attention-limitation.title": "Overcoming serial attention limitation",
+  "overcoming-serial-attention-limitation.description": "This is the Overcoming serial attention limitation page.",
+  "propellant-generation.title": "Propellant Generation",
+  "propellant-generation.description": "This is the Propellant Generation page.",
+  "satellite-operation-services.title": "Satellite Operation Services",
+  "satellite-operation-services.description": "This is the Satellite Operation Services page.",
+  "solar-powered-tesla.title": "Solar-powered Tesla",
+  "solar-powered-tesla.description": "This is the Solar-powered Tesla page.",
+  "solar-system-habitation.title": "Solar System Habitation",
+  "solar-system-habitation.description": "This is the Solar System Habitation page.",
+  "space-based-web-development-platform.title": "Space-based Web Development Platform",
+  "space-based-web-development-platform.description": "This is the Space-based Web Development Platform page.",
+  "space-based-web-hosting.title": "Space-based Web Hosting",
+  "space-based-web-hosting.description": "This is the Space-based Web Hosting page.",
+  "space-launching-services.title": "Space Launching Services",
+  "space-launching-services.description": "This is the Space Launching Services page.",
+  "spacex-automated-with-optimi.title": "SpaceX automated with Optimi",
+  "spacex-automated-with-optimi.description": "This is the SpaceX automated with Optimi page.",
+  "starship-instant-reusability.title": "Starship Instant Reusability",
+  "starship-instant-reusability.description": "This is the Starship Instant Reusability page.",
+  "starship-nano-assembly.title": "Starship Nano-assembly",
+  "starship-nano-assembly.description": "This is the Starship Nano-assembly page.",
+  "terraforming-mars.title": "Terraforming Mars",
+  "terraforming-mars.description": "This is the Terraforming Mars page.",
+  "tesla-automated-with-optimi.title": "Tesla automated with Optimi",
+  "tesla-automated-with-optimi.description": "This is the Tesla automated with Optimi page.",
+  "training-ai-models-in-minutes.title": "Training AI models in minutes",
+  "training-ai-models-in-minutes.description": "This is the Training AI models in minutes page.",
+  "xai-powered-entirely-with-solar.title": "xAI powered entirely with solar",
+  "xai-powered-entirely-with-solar.description": "This is the xAI powered entirely with solar page.",
+  "xais-100m-rubin-equivalent-compute.title": "xAIs 100M Rubin equivalent compute",
+  "xais-100m-rubin-equivalent-compute.description": "This is the xAIs 100M Rubin equivalent compute page.",
+
+  "ai-spaces.title": "AISpaces",
+  "ai-spaces.description": "This is the AISpaces page.",
+  "architecture-decision-records.title": "Architecture Decision Records",
+  "architecture-decision-records.description": "This is the Architecture Decision Records page.",
+  "art-spaces.title": "Art Spaces",
+  "art-spaces.description": "This is the Art Spaces page.",
+  "business-spaces.title": "Business Spaces",
+  "business-spaces.description": "This is the Business Spaces page.",
+  "dating-spaces.title": "Dating Spaces",
+  "dating-spaces.description": "This is the Dating Spaces page.",
+  "delivery-spaces.title": "Delivery Spaces",
+  "delivery-spaces.description": "This is the Delivery Spaces page.",
+  "extended-spaces.title": "Extended Spaces",
+  "extended-spaces.description": "This is the Extended Spaces page.",
+  "freelance-spaces.title": "Freelance Spaces",
+  "freelance-spaces.description": "This is the Freelance Spaces page.",
+  "git-spaces.title": "Git Spaces",
+  "git-spaces.description": "This is the Git Spaces page.",
+  "jobs-spaces.title": "Jobs Spaces",
+  "jobs-spaces.description": "This is the Jobs Spaces page.",
+  "knowledge-base.title": "Knowledge base",
+  "knowledge-base.description": "This is the Knowledge base page.",
+  "spaces.title": "Spaces",
+  "spaces.description": "This is the Spaces page.",
+  "ticket-system.title": "Ticket System",
+  "ticket-system.description": "This is the Ticket System page.",
+  "trade-spaces.title": "Trade Spaces",
+  "trade-spaces.description": "This is the Trade Spaces page.",
+  "video-spaces.title": "Video Spaces",
+  "video-spaces.description": "This is the Video Spaces page.",
+
+  "generic-r&d-center-adr": "Generic R&D Center ADR",
+  "computer-adr": "Computer ADR",
+  "llm-training-adr": "LLM Training ADR",
+  "nano-assembly-adr": "Nano-assembly ADR",
+  "nano-assembler-adr": "Nano-assembler ADR",
+  "3d-printing-adr": "3D-Printing ADR",
+  "3d-printer-adr": "3D-Printer ADR",
+  "automated-design-manufacturing-pipeline-adr": "Automated Design-Manufacturing Pipeline ADR",
+  "falcon-9-and-heavy-nano-assembly-adr": "Falcon 9 & Heavy Nano-Assembly ADR",
+  "starship-instant-reusability-adr": "Starship Instant Reusability ADR",
+  "starship-nano-assembly-adr": "Starship Nano-assembly ADR",
+  "nano-assembled-orbital-heat-shield-adr": "Nano-Assembled Orbital Heat Shield ADR",
+  "3d-printer-for-starships-adr": "3D Printer for Starships ADR",
+  "3d-printing-starships-adr": "3D Printing Starships ADR",
+  "starship-forge-ai-adr": "Starship Forge-AI ADR",
+  "starship-with-a-fusion-engine-adr": "Starship with a Fusion engine ADR",
+  "fusion-starship-adr": "Fusion Starship ADR",
+  "instantly-reusable-launchpad-adr": "Instantly Reusable Launchpad ADR",
+  "nano-assembled-mechazilla-adr": "Nano-Assembled Mechazilla ADR",
+  "nanoassembly-boosted-spacex-adr": "Nanoassembly-boosted SpaceX ADR",
+  "spacex-automated-with-optimi-adr": "SpaceX automated with Optimi ADR",
+  "air-separation-adr": "Air Separation ADR",
+  "fusion-power-plant-adr": "Fusion Power Plant ADR",
+  "nano-assembled-ground-works-adr": "Nano-Assembled Ground Works ADR",
+  "propellant-generation-adr": "Propellant Generation ADR",
+  "smart-starbase-adr": "Smart Starbase ADR",
+  "terraforming-mars-adr": "Terraforming Mars ADR",
+  "compressing-mars-terraforming-adr": "Compressing Mars Terraforming from 100,000+ to 10 years",
+  "mass-driver-adr": "Mass Driver ADR",
+  "solar-system-habitation-adr": "Solar System Habitation ADR",
+  "nano-assembled-starlink-adr": "Nano-Assembled Starlink ADR",
+  "warp-drive-without-negative-energy-adr": "Warp Drive Without Negative Energy ADR",
+  "superluminal-effective-warp-drive-adr": "Superluminal-Effective Warp Drive ADR",
+  "nano-assembled-optimus-adr": "Nano-assembled Optimus ADR",
+  "nano-assembled-cybercab-adr": "Nano-assembled Cybercab ADR",
+  "nano-assembled-semi-adr": "Nano-assembled Semi ADR",
+  "faster-factories-with-optimus-semi-cybercab-adr": "Faster Factories With Optimus Semi Cybercab ADR",
+  "solar-powered-tesla-adr": "Solar-powered Tesla ADR",
+  "tesla-automated-with-optimi-adr": "Tesla automated with Optimi ADR",
+  "optimus-adr": "Optimus ADR",
+  "open-source-cnc-machine-adr": "Open Source CNC Machine ADR",
+  "alternative-hardware-for-ai-training-adr": "Alternative hardware for AI Training ADR",
+  "neuromorphic-computing-adr": "Neuromorphic Computing ADR",
+  "photonic-computing-adr": "Photonic Computing ADR",
+  "quantum-computing-adr": "Quantum Computing ADR",
+  "grok-cad-adr": "Grok CAD ADR",
+  "chip-design-tool-adr": "Chip Design Tool ADR",
+  "engineering-simulation-tool-adr": "Engineering Simulation Tool ADR",
+  "direct-binary-code-generation-adr": "Direct Binary Code Generation ADR",
+  "train-6t-parameter-models-in-minutes-adr": "Train 6t parameter models in minutes ADR",
+  "xai-powered-entirely-with-solar-adr": "xAI powered entirely with solar ADR",
+  "xais-100m-rubin-equivalent-compute-adr": "xAIs 100M Rubin equivalent compute ADR",
+  "healing-autism-perspective-neuralink-bcis-adr": "Healing Autism & Perspective Neuralink BCIs ADR",
+  "neuralink-bci-overcoming-serial-attention-limitation-adr": "[NeuraLink] [BCI] Overcoming serial attention limitation"
+}

package/template/e2e/example.spec.ts

@@ -0,0 +1,15 @@
+import { test, expect } from '@playwright/test';
+
+test('test', async ({ page }) => {
+  await page.goto('http://localhost:3000/');
+  await page.getByRole('combobox', { name: 'Select Category R&D Center' }).click();
+  await page.getByRole('option', { name: 'SpaceX Falcon ADRs' }).click();
+  await page.getByRole('button', { name: 'Falcon 9 & Heavy Nano-' }).click();
+  await page.getByLabel('ADR navigation').getByRole('link', { name: 'decision-record-1 March 2026' }).click();
+  await page.getByRole('link', { name: 'Architecture Decision Records' }).click();
+  await page.getByRole('link', { name: 'Companies' }).click();
+  await page.getByRole('link', { name: 'Products' }).click();
+  await page.getByRole('link', { name: 'Services' }).click();
+  await page.getByRole('link', { name: 'Apps' }).click();
+  await page.getByRole('main').getByRole('link', { name: 'Architecture Decision Records' }).click();
+});

package/template/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/template/get-dictionary.ts

@@ -0,0 +1,21 @@
+import "server-only";
+import type { Locale } from "@/i18n-config";
+
+// All supported locales must be listed here
+const dictionaries = {
+  en: () => import("@/dictionaries/en.json").then((module) => module.default),
+  de: () => import("@/dictionaries/de.json").then((module) => module.default),
+} as const;
+
+// Fallback to English if locale is missing or invalid
+export const getDictionary = async (locale: Locale): Promise<any> => {
+  // Safe access with fallback
+  const loader = dictionaries[locale] ?? dictionaries.en;
+
+  if (!loader) {
+    // This should never happen if you have at least 'en'
+    throw new Error(`No dictionary found for locale: ${locale}`);
+  }
+
+  return loader();
+};

package/template/i18n-config.ts

@@ -0,0 +1,6 @@
+export const i18n = {
+  defaultLocale: 'en',
+  locales: ['en', 'de'],
+} as const;
+
+export type Locale = (typeof i18n)['locales'][number];

package/template/mdx-components.tsx

@@ -0,0 +1,56 @@
+// // mdx-components.tsx
+// "use client";
+
+// import type { MDXComponents } from "mdx/types";
+// import CodeBlock from "@/app/[lang]/components/CodeBlock";
+// import MathBlock from "@/app/[lang]/components/MathBlock";
+// import React from "react";
+
+// type Dictionary = Record<string, string>;
+
+// export function getMDXComponents(dict: Dictionary = {}): MDXComponents {
+//   return {
+//     pre: (props: any) => <CodeBlock {...props} />,
+
+//     T: ({
+//       id,
+//       ...props
+//     }: { id: string } & React.HTMLAttributes<HTMLSpanElement>) => (
+//       <span {...props}>{dict[id] ?? id}</span>
+//     ),
+//     // Intercept block-level formulas generated by MathJax using a dynamic element factory
+//     "mjx-container": (props: any) => {
+//       // Only wrap standalone block equations (display="true"), keep inline formulas ($...$) un-wrapped
+//       if (props.display === "true") {
+//         return <MathBlock {...props} />;
+//       }
+
+//       // Dynamic rendering bypasses JSX.IntrinsicElements validation limits
+//       return React.createElement("mjx-container", props);
+//     },
+//   };
+// }
+
+"use client";
+
+import type { MDXComponents } from "mdx/types";
+import CodeBlock from "@/app/[lang]/components/CodeBlock";
+import MathBlock from "@/app/[lang]/components/MathBlock"; // Import the component
+
+type Dictionary = Record<string, string>;
+
+export function getMDXComponents(dict: Dictionary = {}): MDXComponents {
+  return {
+    pre: (props: any) => <CodeBlock {...props} />,
+    T: ({
+      id,
+      ...props
+    }: { id: string } & React.HTMLAttributes<HTMLSpanElement>) => (
+      <span {...props}>{dict[id] ?? id}</span>
+    ),
+
+    // Register the component directly.
+    // This leaves standard $$...$$ formulas alone while enabling <MathBlock> triggers.
+    MathBlock,
+  };
+}

package/template/next.config.ts

@@ -0,0 +1,67 @@
+// // next.config.ts
+// import type { NextConfig } from "next";
+// import rehypePrettyCode from "rehype-pretty-code";
+// import moonlightTheme from "./public/assets/moonlight-ii.json" with { type: "json" };
+
+// /** @type {import('rehype-pretty-code').Options} */
+// const rehypePrettyCodeOptions = {
+//   keepBackground: false,
+//   theme: {
+//     light: "github-light",
+//     dark: "github-dark-dimmed",
+//   },
+//   grid: true,
+// };
+
+// /** @type {import('next').NextConfig} */
+// const nextConfig: NextConfig = {
+//   // Configure `pageExtensions` to include markdown and MDX files
+//   pageExtensions: ["js", "jsx", "md", "mdx", "ts", "tsx"],
+//   // Optionally, add any other Next.js config below
+// };
+
+// const withMDX = createMDX({
+//   // Add markdown plugins here, as desired
+//   extension: /\.(md|mdx)$/,
+//   options: {
+//     remarkPlugins: [],
+//     rehypePlugins: [[rehypePrettyCode, rehypePrettyCodeOptions]],
+//   },
+// });
+
+// // Merge MDX config with Next.js config
+// export default withMDX(nextConfig);
+
+// next.config.ts
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  // pageExtensions: ["js", "jsx", "md", "mdx", "ts", "tsx"],
+  pageExtensions: ["js", "jsx", "ts", "tsx"],
+  // Add any other Next.js config you already have here
+
+  // FIX error:
+  // ⨯ Error: Cannot find module '/Users/cybyrynth/Research-and-Development-Center/architecture-decision-records/.next/dev/server/package.json'
+  // type: 'Error',
+  //   code: 'MODULE_NOT_FOUND',
+  //   requireStack: [
+  //     '/.next/dev/server/chunks/ssr/node_modules_mathjax-full_js_0m4il~j._.js',
+  //     '/.next/dev/server/chunks/ssr/[turbopack]_runtime.js',
+  //     '/.next/dev/server/app/[lang]/mdx-page/page.js',
+  //     '/node_modules/next/dist/server/require.js',
+  //     '/node_modules/next/dist/server/load-components.js',
+  //     '/node_modules/next/dist/server/dev/static-paths-worker.js',
+  //     '/node_modules/next/dist/compiled/jest-worker/processChild.js'
+  //   ],
+  //   page: '/en/mdx-page'
+
+  // The reason this error continues to loop is because Next.js 16's stable
+  // Turbopack bundle compilation ignores custom code aliases for deeply nested
+  // sub-dependencies like mathjax-full. When mathjax-full runs on the server
+  // inside an isolated MDX stream component, it tries to read its internal
+  // package.json configurations using classic require(), breaking because
+  // Turbopack creates a sandboxed virtual runtime memory space instead.
+  serverExternalPackages: ["mathjax-full"],
+};
+
+export default nextConfig;