qwikifiers / qwik-ui

Qwik's official Headless and styled component library
https://qwikui.com
MIT License
558 stars 115 forks source link

Searchable docs #711

Open osdiab opened 3 weeks ago

osdiab commented 3 weeks ago

Right now the docs have no site wide search, which makes it hard to find things. Would be great if this docs site supported this like other modern libraries.

thejackshelton commented 3 weeks ago

Completely agree. Would you like to take a stab at it @osdiab ?

JerryWu1234 commented 1 week ago

let me take this pr, but Could you provide any requirement for searching library that we will be using this project?

thejackshelton commented 1 week ago

let me take this pr, but Could you provide any requirement for searching library that we will be using this project?

Sure! I think in particular something similar to Kobalte here: https://kobalte.dev/docs/core/overview/introduction

https://github.com/qwikifiers/qwik-ui/assets/104264123/20b95446-5092-4e13-b3c8-c62fa71f7127

This uses Algolia, which the Qwik docs also use if you're looking for a source of inspiration.

Ideal search functionality

As for the searching component behavior, you may be able to use the Qwik UI combobox for searching. It is in a big need of a refactor, but for the time being it could work (unless there is a more seamless solution).

If you run into any trouble @JerryWu1234 happy to answer questions and chat in voice! At some point I will be refactoring the Combobox in the near future.

If we think algolia is the way to go, I'd be happy to make an account for it and get us set up, and hand it off.

JerryWu1234 commented 5 days ago

@thejackshelton Do I use my algolia accounts or you offer one ?

PatrickJS commented 3 days ago

@shairez can you get algolia account

shairez commented 3 days ago

Just opened an algolia account for Qwik UI 🎉

If you have experience with it please DM me on discord, it'll probably save me some of the setup time