Article
Build a project filter you can send to someone
A filter is easier to use when a shared link, a reload and the Back button all bring readers to the results they expect.
Start with the link
Imagine a hiring manager finds three Python projects in a directory and sends the page to a colleague. Opening that link should show the same three projects. Give the filter a stable query parameter, such as ?language=python, and have the server use it when rendering both the results and the selected option.
Make changing the filter predictable
A labelled select inside a GET form gives the reader a way to change the language with a keyboard. Keep an Apply button so someone moving through the options can finish choosing before the page changes. If you later update results in place, update the address at the same time. Announce the result count to screen readers and preserve focus on the control the reader just used.
Try the journey from a fresh window
Apply two different filters, press Back, and compare the visible selection, count and projects with the address bar. Open the resulting link in a fresh window and repeat the search with scripts disabled. Finally, select a combination with zero results. Show the active filters and a link that clears them. That small detail gives the reader a way out of an empty directory.