Unexpected Error When Running yarn start After No Recent Changes

[kmlbgn]

Hello,

I haven’t made any changes to my repo for a while, and today I ran yarn start to test if everything was still working before making an update. To my surprise, I encountered the following error:

[ERROR] Error: Expected usable value but received an empty preset, which is probably a mistake: presets typically come with `plugins` and sometimes with `settings`, but this has neither
    at addPreset (file:///Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/unified/lib/index.js:1110:15)
    at add (file:///Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/unified/lib/index.js:1097:11)
    at addList (file:///Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/unified/lib/index.js:1134:11)
    at Function.use (file:///Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/unified/lib/index.js:1074:9)
    at createProcessor (file:///Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@mdx-js/mdx/lib/core.js:209:6)
    at createProcessorSync (/Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@docusaurus/mdx-loader/lib/processor.js:130:30)
    at createProcessors (/Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@docusaurus/mdx-loader/lib/processor.js:165:22)
    at async normalizeOptions (/Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@docusaurus/mdx-loader/lib/createMDXLoader.js:21:45)
    at async createMDXLoaderItem (/Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@docusaurus/mdx-loader/lib/createMDXLoader.js:38:18)
    at async createMDXLoaderRule (/Users/kmlbgn/Dev/KIRA/docs.kira.network/node_modules/@docusaurus/mdx-loader/lib/createMDXLoader.js:45:15)

This issue is unexpected since the setup was previously working fine and I am not using presets. I haven’t modified any configurations or dependencies recently.
Could this be related to an upstream change in Docusaurus or one of its dependencies?
Here is my config file :

const { themes } = require("prism-react-renderer");

const config = {
  title: "KIRA",
  tagline: "Public documentation of the KIRA network",
  url: "https://docs.kira.network",
  favicon: "https://ipfs.kira.network/ipfs/QmRqfyEvBoSj6sapjyhQqTJfwQPmsDkMQrxyqtTC6bZcTU",
  organizationName: "KiraCore",
  projectName: "docs.kira.network",
  deploymentBranch: "docs.kira.network",

  baseUrl: "/",
  trailingSlash: true,
  onBrokenLinks: "warn",
  onBrokenMarkdownLinks: "warn",

  plugins: [
    [
      '@docusaurus/plugin-content-docs',
      {
        id: 'default',
        path: 'tabs/learn',
        routeBasePath: '/learn/',
        showLastUpdateTime: true,
        remarkPlugins: [require('remark-math')],
        rehypePlugins: [require('rehype-katex')],
        editUrl: ({docPath, permalink}) => {
          docPath = docPath.toLowerCase();
          const repoUrl = `https://github.com/KiraCore/docs.kira.network/issues/new?assignees=&labels=documentation,issue&projects=&template=report_an_issue.yaml&title=%5BISSUE+REPORT%5D&page-github=${permalink}&page-local=${docPath}`;
          return repoUrl;
        },
      },
    ],
    [
      '@docusaurus/plugin-content-docs',
      {
        id: 'testnet',
        path: 'tabs/testnet',
        routeBasePath: '/testnet/',
        showLastUpdateTime: true,
        remarkPlugins: [require('remark-math')],
        rehypePlugins: [require('rehype-katex')],
        editUrl: ({docPath, permalink}) => {
          docPath = docPath.toLowerCase();
          const repoUrl = `https://github.com/KiraCore/docs.kira.network/issues/new?assignees=&labels=documentation,issue&projects=&template=report_an_issue.yaml&title=%5BISSUE+REPORT%5D&page-github=${permalink}&page-local=${docPath}`;
          return repoUrl;
        },
      },
    ],
    [
      '@docusaurus/plugin-content-docs',
      {
        id: 'docs',
        path: 'tabs/docs',
        routeBasePath: '/docs/',
        showLastUpdateTime: true,
        remarkPlugins: [require('remark-math')],
        rehypePlugins: [require('rehype-katex')],
        editUrl: ({docPath, permalink}) => {
          docPath = docPath.toLowerCase();
          const repoUrl = `https://github.com/KiraCore/docs.kira.network/issues/new?assignees=&labels=documentation,issue&projects=&template=report_an_issue.yaml&title=%5BISSUE+REPORT%5D&page-github=${permalink}&page-local=${docPath}`;
          return repoUrl;
        },
      },
    ],
    [
      '@docusaurus/plugin-content-docs',
      {
        id: 'ecosystem',
        path: 'tabs/ecosystem',
        routeBasePath: '/ecosystem/',
        showLastUpdateTime: true,
        editUrl: ({docPath, permalink}) => {
          docPath = docPath.toLowerCase();
          const repoUrl = `https://github.com/KiraCore/docs.kira.network/issues/new?assignees=&labels=documentation,issue&projects=&template=report_an_issue.yaml&title=%5BISSUE+REPORT%5D&page-github=${permalink}&page-local=${docPath}`;
          return repoUrl;
        },
      },
    ],
  ],
  stylesheets: [
    {
      href: 'https://cdn.jsdelivr.net/npm/katex@0.13.24/dist/katex.min.css',
      type: 'text/css',
      integrity:
        'sha384-odtC+0UGzzFL/6PNoE8rX/SPcQDXBJ+uRepguP4QkPCm2LBxH3FA3y+fKSiJ+AmM',
      crossorigin: 'anonymous',
    },
  ],

  i18n: {
    defaultLocale: 'en',
    locales: ['en'],
  },

  themes: [
    [
      require.resolve("@easyops-cn/docusaurus-search-local"),
      {
        hashed: true,
        indexBlog: false,
        indexPages: false,
        docsRouteBasePath: "/",
      },
    ],
  ],
  themeConfig:{
      metadata: [
        {
          name: "keywords",
          content: "Kira Network, KEX, documentation, help, INTERX, MIRO, KIRA, SEKAI",
        },
      ],
      theme: {
        customCss: [
          require.resolve("./css/kira.css"),
          require.resolve("./css/docu-notion-styles.css"),
        ],
      },
      sitemap: {
        changefreq: "weekly",
        priority: 0.5,
        ignorePatterns: [],
      },
      navbar: {
        logo: {
          alt: "Logo",
          src: "https://ipfs.kira.network/ipfs/QmcNyQRYDBD6qBH19Ab7eqtWZ59nLqBjvM4BCwnkexd78y/LOGO-SYMBOL/KIRA-WT-V2.svg",
          href: '/learn/',
        },

        items: [
          {
            type: 'doc',
            label: 'Learn',
            docId: 'what-is-kira/introduction',
            docsPluginId: 'default',
            position: 'left',
            activeBaseRegex: '^/learn/',
          },
          {
            type: 'doc',
            label: 'Docs',
            docId: 'introduction',
            docsPluginId: 'docs',
            position: 'left',
            activeBaseRegex: '^/docs/',
          },
         {
                type: 'dropdown',
                label: 'Build',
                position: 'left',
                // activeBaseRegex: '^/testnet/',
                items: [
                        {
                          type: 'doc',
                          docId: 'testnet-servers/active/chaosnet-2',
                          label: 'Testnet',
                          docsPluginId: 'testnet',
                          activeBaseRegex: '^/testnet/',
                        },
                        {
                          type: 'doc',
                          docId: 'evangelist',
                          label: 'Ecosystem',
                          docsPluginId: 'ecosystem',
                        },
            ]
        ]
      },
      tableOfContents: {
        minHeadingLevel: 2,
        maxHeadingLevel: 4,
      },
      colorMode: {
        defaultMode: 'dark',
        disableSwitch: true,
      },
      prism: {
        darkTheme: themes.dracula,
        additionalLanguages: ['bash','go'],
      },
    },
};

module.exports = config;

[slorber]

If you use a lockfile then no Docusaurus or any update from npm could create such issue since it's the exact same code on your file system.

You must have changed something on your env (package manager, OS, Node version...).

[kmlbgn]

This is not the repo I am using, this one is old and no longer up to date.

https://github.com/KiraCore/docs.kira.network

but in any case, i find it weird that it is not running the tutorial as it should. Any other caching mechanism involved ?

[slorber]

Not that I can think of, you are the first to encounter this issue with our tutorial.

Your site starts in an isolated StackBlitz sandbox: https://stackblitz.com/~/github.com/KiraCore/docs.kira.network/tree/master

This is likely a local env issue, not a bug in our code or dependencies

[kmlbgn]

Thanks, i'm investigating

[kmlbgn]

@slorber traced this issue back to this unifiedjs/unified#200
When I comment all the remark and rehype plugins on each docs plugin instances in config file above, yarn start goes through.
I rolled back my node.js version to v20.18.2 and it worked. Not sure if new version breaks on docusaurus side or unified side.

[slorber]

So I guess the problem was upgrading Node locally

Maybe in the past, you used Volta and this precisely defined version:

[MingweiSamuel]

Switching docusaurus.config.js from cjs to mjs imports fixed this for me, see this diff: hydro-project/hydro#1855