Docusaurus Build Fails With Module Not Found

Sub-skill of docusaurus: Build Fails with Module Not Found (+6).

vamseeachanta Updated

File contents

Build Fails with Module Not Found (+6)

Build Fails with Module Not Found

rm -rf node_modules .docusaurus build
npm install
npm run build

Hot Reload Not Working

npm run clear
npm run start

Broken Links

module.exports = {
  onBrokenLinks: 'warn', // Change from 'throw' for debugging
};

i18n Build Issues

npm run build -- --locale en
npm run write-translations -- --locale fr

Debug Mode

DEBUG=docusaurus* npm run build
npm run start -- --port 3001

Algolia Indexing Issues

// Check Algolia configuration
module.exports = {
  themeConfig: {
    algolia: {
      appId: 'YOUR_APP_ID',       // Not the API key
      apiKey: 'SEARCH_ONLY_KEY',  // Search-only API key
      indexName: 'your_index',
      debug: true,                // Enable debug mode
    },
  },
};

Version Dropdown Not Showing

// Ensure versions.json exists and navbar is configured
module.exports = {
  themeConfig: {
    navbar: {
      items: [
        { type: 'docsVersionDropdown', position: 'right' },
      ],
    },
  },
};

vamseeachanta/workspace-hub/tree/main/.agents/skills/_archive/development/documentation/docusaurus/build-fails-with-module-not-found commit c3252bac8b

Frequently asked questions

npx skillmds@latest add vamseeachanta/docusaurus-build-fails-with-module-not-found