Add search and filter for rulings

[erikhuizinga]

See also this comment on the Wingspan Facebook group: https://www.facebook.com/groups/wingspanboardgame/posts/1116867439016857/?comment_id=1117031645667103

Original idea

Have a website to search (and filter) the rulings maintained by Travis Willse (TawnyFrogmouth).

I've considered building this myself, but because Wingsearch is a well-known resource in the Wingspan player base, it makes sense to add a feature like this to maximise its reach. Besides, Wingsearch already incorporates the rulings. They can be found from a bird -> related rulings. The other way around could also be possible: have some list of rulings and find all birds, bonus cards, expansions, etc., that apply to it.

Story

As a player, I want to be able to play with (any subset of) all future base game(s) and expansion content and find how to apply certain rulings that might occur.

Players might find rulings by searching for a specific bird, but searching for a ruling could be easier in some cases, to also find all birds and other components/mechanisms/expansions (e.g. bonus cards already in Wingsearch) that are related.

Implementation

Of course, the current UI should change as little as possible. The current Wingsearch list shows birds and bonus cards below them. That is what Wingsearch users expect to find when they load the page.

One option would be to simply add them below the bonus cards. This might be the simplest solution, but it might complicate the already feature-packed filters. Besides, these filters will likely grow in the future with all upcoming expansion material. So I suggest to consider an alternative: at the top of the screen, Wingsearch could show something like a switch, or tabs, so that users can switch to an entirely different view that searches for rulings instead of the birds/bonus cards.

On this rulings search view, they can enter any query for a full text search, like on the bird/bonus cards search screen. If this is kept simple, it would be enough to only show the ruling, its source(s)/reference(s) and possibly the related birds/bonus cards. As possible (future) extensions, references to other game features could also be shown, like to which expansions this applies (e.g. Oceania), or what game rules and component are directly involved (e.g. spending nectar). For game rules, links could be provided to https://rulepop.com/wingspan/ (supports base, Swift Start, Europe, Oceania, but not yet Asia).

[erikhuizinga]

I'd be happy to contribute, by working out more details and discussing possible implementation paths with you. Note that I'm not a TS developer, but I'm sure that I can manage to learn it. I'd only need some help setting up my development environment. For this you could consider adding a CONTRIBUTING.md file.

[navarog]

Hi Erik!

Sorry for taking so long to answer this. I am happy with the idea, and feel free to work on it. I added a CONTRIBUTING.md file. If you have a preliminary version, please submit a PR, and I can assist you if needed.