Browse

The feed at / is where tsundoku's purpose shows up: a paginated grid of series the resolver has linked at least one release to. Filters scope the set; presets remember combinations worth keeping around.

Filters

The left rail lives in the URL — copy the address bar to share or bookmark a view, no preset required.

Text search

Free-text query (q). Server-side: Dice-coefficient rerank against canonical + alternate titles, with an FTS5 prefix-match boost so correctly-spelled queries beat fuzzy ones. Whitespace-only is treated as absent. Results are always relevance-ordered when q is set — the Sort by dropdown is ignored.

Kind / Status

Single-select combo boxes against series.type (manga, manhwa, manhua, novel, one_shot, other) and series.status (ongoing, completed, hiatus, cancelled, unknown). Both are open-ended on the backend — type a value the resolver hasn't written yet and the filter still applies.

Genres / Tags

Multi-select chip grids, sorted alphabetically. Each chip shows the series count so an unused genre doesn't look the same as a popular one. A typeahead narrows the chip list as you type.

The All / Any toggle sits at the top of each group:

• Any (default) — keep series matching at least one selected name. The toggle is disabled with a single chip selected (the modes are equivalent there).
• All — keep only series matching every selected name. Backend uses GROUP BY series_id HAVING COUNT(DISTINCT name) = N, so a series carrying some but not all of the chosen names is correctly excluded.

The toggle becomes active once two or more chips are selected. The clear-button (×) next to the section title wipes the whole group in one click.

Genres and tags are AND-combined with each other and with every other filter. Example: genres = [Action] (any), tags = [isekai] (any) returns series tagged isekai and in the Action genre, not the union.

Releases

Tri-state segmented control over the orphan / has-releases axis:

• Any — no constraint (default).
• Orphans — series with zero linked releases. Usually the residue of a manual re-link in the review queue.
• Has releases — series with ≥1 linked release.

Sort by / Order

Sort field	Default order	Notes
last_release_at	Newest first	Default.
first_seen_at	Newest first	When the catalog first saw the series.
total_volumes	Highest first	Provider-reported volume count. NULLs sink to the bottom in both directions.
total_chapters	Highest first	Same null-handling as volumes.

The Order dropdown's labels rephrase themselves for numeric vs. date sorts: "Newest first / Oldest first" for dates, "Highest first / Lowest first" for counts.

Sort and order are ignored when a search query is set — search is relevance-first by design.

Presets

The Save button stores the current filter set in localStorage (key tsundoku.filter-presets.v1) under a name you provide. Saved presets show up in the Presets menu; clicking one overwrites the URL with that preset's filters.

Useful combinations:

• "Action ongoing, no novels" — kind=manga, status=ongoing, genres=[Action].
• "Recent orphans to triage" — hasReleases=false, sort=first_seen_at.
• "Volumes I've never heard of" — sort=total_volumes, order=desc.

Presets live client-side only. There's no sync between devices, and clearing browser storage drops them.

View modes

The Cards / List toggle in the page header is sticky via the view URL param. Cards are the default; list view is denser and better for sort-by-count comparisons.

Both views show:

• Cover (placeholder when the provider has none).
• Canonical title, year, kind, status badges.
• Linked release count (e.g. 5 REL) and an OWNED badge for series Codex has imported (see the ownership note for why this is reserved infrastructure today).

Click any card to drill into the series detail page.

Pagination

Default page size is 24 (cards) / matches the same page-size in list view. The pagination control sits at the bottom; the page number lives in the URL via ?page=N.

Filter changes reset to page 1 automatically — a narrower result set can't strand you on page 7 of nothing.

Series detail

The detail page (/series/{id}) is reached by clicking any card. It shows the full description, alternate titles, every external-ID mapping the resolver has on file, and the full release list.

The release list has a per-row Move action: re-link a release that landed on the wrong series. The modal accepts either a catalog series id (paste from another detail page) or a provider search result. Useful when the fuzzy resolver picked the wrong target and you want to fix it after the fact without retrying the whole row.

API

Everything above maps to GET /api/v1/series. Genre and tag CSVs plus genresMode / tagsMode are documented in the API reference.