Search by themes

Themes are guided paths provided by Scripvio: each theme launches a preconfigured Bible search (query + server topic id). You explore a subject (faith, prayer, etc.) without starting from an exact reference.

→ Overview · By keyword

Where to find themes?

Research tab.
Scroll to Explore by theme.
FilterChip labels (interface language / server data).
Tap a chip → search runs automatically; the input shows the theme’s default query.

Themes load from the server on page load (pull-to-refresh to reload).

What happens on tap

sequenceDiagram
  participant U as You
  participant A as App
  participant S as Server
  U->>A: Tap theme Faith
  A->>S: search(q=defaultQuery, type=topic, topic=slug)
  S-->>A: Results + Version
  A-->>U: Results list

Element	Source
Display label	theme `label`
Field text	`default_query`
Technical id	`slug` (sent to API)

Recent searches then stores the query like any other search.

Using theme results

Same as any search:

Action	Label
Read	Open passage
Copy	Copy reference
Note	Add to a note (draft)
Journal	Add to journal (draft)
Tracking	Log meditation

→ Reuse in notes and journal

Themes vs free keyword

	Theme	Typed keyword
Entry	Chip under Explore by theme	Field + Search
Query	Product-defined	You-defined
API type	`topic` + slug	`auto`
Use	Discovery, teaching	Targeted study

You may edit the field after tapping a theme and press Search again (auto).

Connection and errors

Situation	Behavior
Online	Theme list visible
Loading	Progress indicator
Load error	Error under section (refresh to retry)
Offline	Search banner; themes may not load
Theme with no hits	No results. Try another wording or a reference.

Teaching tips

Goal	Suggested path
Sermon prep on a topic	Nearby theme → skim Results → Add to a note draft
Personal retreat	Theme → Open passage → Log meditation
Journal supplement	Theme → verse → Add to journal (today’s draft)

Frequently asked questions

Custom themes?
Not on mobile — list comes from the server (product updates without app release).

Same themes in all languages?
Labels follow locale/API; Bible content depends on displayed Version.

Themes replace reference search?
No — complementary. For one verse, use By reference.

Topic	Link
Overview	Overview
Keywords	By keyword
Reuse	Reuse