docs(algolia-ui-libraries): correct Angular status and add current options - #34
Open
itsdanwilli wants to merge 1 commit into
Open
docs(algolia-ui-libraries): correct Angular status and add current options#34itsdanwilli wants to merge 1 commit into
itsdanwilli wants to merge 1 commit into
Conversation
…tions Re-verified against npm and algolia.com/doc (2026-08-06): - angular-instantsearch is formally deprecated with no successor, not just 'not compatible with the latest Angular versions'. Added the npm deprecation notice, the /doc/deprecated relocation, and the official migration guide. - Warn that Algolia's own /developers and /products pages still present Angular as maintained, so status should be confirmed from npm and /doc. - Never recommend react-instantsearch-dom or react-instantsearch-hooks-web; both are deprecated in favour of react-instantsearch. - Next.js App Router requires react-instantsearch-nextjs (InstantSearchNext, 'use client'); note there is no RSC-native InstantSearch, and that Algolia recommends frontend over backend search. - Add lower-code options a 2026 selector should cover: SiteSearch (beta) and Algolia Experiences, plus Composition's constraints and a DocSearch version caution. - Note Flutter ships helpers only, with no UI widgets, and that no official web-components, Svelte, Astro or Angular library exists. Validator: 129 passed, 0 failed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
itsdanwilli
added a commit
to algolia/implementation-skills
that referenced
this pull request
Aug 6, 2026
…source repo Skill content had drifted three ways within a day (site mirrors, the private source repo, and upstream), so this removes every duplicate copy. algolia/skills is now the single source: it is a submodule at vendor/algolia-skills, read directly by the packaging scripts. The 11 top-level algolia-*/ mirror folders are deleted, and nothing referenced them. - packaging/suite.json declares which skills this site ships - artifacts/ is canonical and hand-edited; sync:artifacts copies it to public/artifacts/ for serving. Skills are never copied anywhere. - scripts/validate-skills.mjs moved in from the private repo and validates the suite inside the submodule - packaging/library-README.md replaces the private repo's README in the library ZIP and points at algolia/skills as canonical - npm run skills:update bumps the pin TEMPORARY: the submodule is pinned to the chore/ui-library-currency commit (algolia/skills#34), not main, because the UI-library corrections already in the shipped ZIPs are not on main yet. Rebuilding against main would have regressed the live downloads. Move it back with skills:update once #34 merges. release:prepare verified end to end: 17 archives, 11 skills, 0 failures. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #33. The selector reference had one materially wrong claim and several gaps. All re-verified against npm and
algolia.com/docon 2026-08-06.The correction that matters
angular-instantsearchis formally deprecated with no successor — the npm package carries a deprecation notice, its docs moved under/doc/deprecated/, and Algolia has stated it will not ship an Angular replacement. The file previously said only that it was "not compatible with the latest Angular versions," which understates it: a reader could reasonably conclude it still receives support. Added the official migration guide.Also added a caution that Algolia's own
/developersand/productsmarketing pages still present Angular as an available, maintained flavor — so library status should be confirmed from npm and/doc, not marketing pages. That contradiction is easy to trip over.Other fixes
react-instantsearch-domorreact-instantsearch-hooks-web— both npm-deprecated in favour ofreact-instantsearchand frozen since 2023.react-instantsearch-nextjs(InstantSearchNext, own file,"use client"). Plainreact-instantsearchis not App-Router-SSR-ready alone, and there is no RSC-native InstantSearch — the widgets are client components by design. Also noted Algolia documents a backend-search pattern but recommends frontend search.indexwidget, cannot mix with Search/Recommend on the same page) and a caution that DocSearch has moved past v3.algolia_helper_flutteris business-logic helpers only, no UI widgets.Deliberately no pinned version numbers: this reference is a living selector, which is why it aged well. These are status and option facts instead.
scripts/validate_skills.py: 129 passed, 0 failed.🤖 Generated with Claude Code