Skip to content

Conversation

@solidusite
Copy link

@solidusite solidusite commented Jan 24, 2026

Types of changes

  • New feature (a non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Description

This PR introduces a major update of the Algolia/Nuxt stack along with a comprehensive refactor of the Algolia module.

Specifically:

  • Upgraded Algolia to v5.x
  • Upgraded Nuxt to v4.x
  • Upgraded DocSearch to v4.x
  • Refactored the Nuxt Algolia module, the documentation (Docus), and the playground, including complete and up-to-date examples
  • Added a new feature allowing the use of multiple DocSearch instances on the same page

These changes improve compatibility with the latest dependency versions, enhance code maintainability, and provide greater flexibility when integrating DocSearch in more advanced use cases (e.g. complex layouts or multi-search scenarios).

Checklist:

  • I have updated the documentation accordingly.
  • Refactor crawler & indexer
  • Test suites

- Translated various sections of the DocSearch examples from Italian to English for better accessibility.
- Updated example descriptions and placeholders to reflect the new translations.
- Enhanced user experience by providing clearer instructions and descriptions in the examples.
- Improved code comments and documentation for better understanding of functionalities.
- Removed environment variable dependencies in nuxt.config.ts for Algolia DocSearch configuration.
- Re-exported types from algoliasearch in types.ts, streamlining type management.
- Enhanced AlgoliaDocSearch.vue to ensure unique container IDs are generated on the client side, improving SSR compatibility.
- Added fallback mechanisms for container ID selection to prevent errors during initialization.
- Simplified nuxt.config.ts by removing unused modules and adding essential ones for content management and image optimization.
- Introduced a new AppHeaderLogo component for improved branding in the application header.
- Reorganized documentation structure by replacing outdated index files and enhancing content with clearer descriptions and navigation.
- Added new markdown files for getting started, installation, and project structure to facilitate user onboarding.
- Updated package.json to include necessary dependencies and scripts for development and production builds.
@solidusite solidusite marked this pull request as draft January 24, 2026 21:58
- Deleted .eslintignore and .eslintrc files to streamline project configuration.
- Updated build.config.ts to include '@docsearch/react' in the dependencies.
- Enhanced eslint.config.mjs by appending custom rules for Vue component naming.
- Added @nuxt/eslint-config as a development dependency in package.json.
- Made minor adjustments to various files for consistency and improved readability.
- Removed the "type" field from package.json for cleaner configuration.
- Updated type definitions in types.ts to use 'unknown' instead of 'any' for better type safety.
- Refactored crawler.ts to simplify the Algolia client initialization and batch object handling.
- Enhanced AlgoliaDocSearch.vue for improved readability and maintainability by restructuring conditional logic.
- Cleaned up useAlgoliaInitIndex.ts by removing unnecessary type exports.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant