• Front (dark) — Scripture reference (e.g., "John 3:16")
• Back (cream) — Full scripture text

Tap anywhere on the card to flip it. On desktop, press Space or Enter.

Every card shows a status badge in the top-right corner:

After flipping, three buttons appear:

Desktop: ↑ = Got It, ↓ = Still Learning (card must be flipped).

To edit: Flip card → tap ✏️ → edit reference or text → Save Changes.

To delete: Flip card → tap ✏️ → tap 🗑 Delete This Card → confirm.

• Card — current card number
• Known — cards marked Got It
• Total — total cards in deck
• Streak — consecutive Got It answers
• Progress bar — % of Known cards

All progress saves automatically. Closing the app or restarting your phone does not erase data. Each deck tracks its own Known count, streak, and current card independently.

A deck is a set of scripture cards. The app shows your decks as color-coded tabs in a strip just below the title. Each deck keeps its own cards, progress, streak, and quiz history.

All five open as tabs the first time you load the app. Built-in decks can be renamed and recolored, but not deleted.

Tap any tab to switch to that deck. The stats, progress bar, card, Speak, and Quiz all instantly apply to the deck you're viewing.

1. Press and hold a tab for about half a second — it "lifts" with a slight zoom and shadow (phones give a small buzz).
2. While still holding, drag it left or right; other tabs slide out of the way.
3. Release to drop it in the new spot. The new order is saved.

When you have more tabs than fit, the strip scrolls. Swipe it on a phone, or on a computer use the mouse wheel over the strip, drag it, or use the thin scrollbar. A soft fade on the right edge hints there's more.

1. Tap + on the tab strip → "Create New Deck".
2. Enter a name and pick a color.
3. Tap Save — the new empty deck opens as a tab.
4. Add verses with "+ Add Card", Get Scripture, Search, or Import.

Tap the currently active tab a second time to open Deck Options. There you can rename the deck, change its color, or — for your own decks — delete it.

The + button opens the Deck Library — a list of every deck (open and closed) with its card count and known count, plus the "Create New Deck" button.

The app reads Scripture using the text-to-speech voices built into your device. The quality depends on your device — and there is an important limit on iPhone:

On iPhone / iPad: Apple only allows browser-based apps — this app, and any website — to use its basic voices, such as "Samantha." The nicer Enhanced, Premium, and Siri voices you can download in Settings are reserved by Apple for the system and are not available to web apps. So on iPhone the reading voice sounds plain. This is an Apple restriction the app cannot change.

On Android: you often can improve the voice — Settings → search "Text-to-speech" → tap the gear by your speech engine → install higher-quality voice data → then pick it in the app's ⚙️ Voice list.

On a computer: Chrome and Edge usually offer good, natural voices in the ⚙️ Voice list.

1. App speaks the reference aloud.
2. Pauses for your configured pause interval (time to recall!).
3. Card flips to the back automatically.
4. App speaks the full scripture text.
5. Repeats from step 1 — loops the same card forever until ⏹ Stop.

1. Builds a list of only STILL LEARNING cards.
2. Starts at the closest Still Learning card to your current position.
3. Screen jumps over Got It cards — speech and display both skip them.
4. After the last Still Learning card, loops back and repeats forever.
5. Tap ⏹ Stop at any time.

• English cards → reads in English 🇺🇸
• Chinese cards → reads in Mandarin Chinese 🇨🇳
• Mixed deck → switches language card by card automatically

1. Settings → Accessibility → Spoken Content → Voices.
2. Tap Chinese → tap ⬇ next to Tingting or Meijia.
3. Wait for download. Return to app.

• Voice Picker — all voices on your device, grouped by language. ☁ = cloud voice.
• Speed Slider 🐢→🐇 — 0.4× (very slow) to 1.6× (very fast). Default 0.88×.
• Pause Interval ⏱→⌛ — 1 to 60 seconds between reference and scripture text.
• ▶ Test Voice — hear a sample before committing.

1. Tap "+ Add Card".
2. Type the reference (e.g., "Romans 8:28").
3. Use Get Scripture, Search 🔍, or type text manually.
4. Tap "Save Card".

Auto-fetches ESV verse text for any reference you type.

1. Tap 🔍 next to the Reference field.
2. Type a word or phrase. Select a scope (Entire Bible, OT, NT, or any book).
3. Tap 🔎 Find — results appear with matched words highlighted in gold.
4. Scroll down and tap "⬇ Load More Results" for more matches.
5. Tap any result → reference and text fill in automatically.
6. Tap "Save Card".

• * — any characters: "lov*" matches love, loved, loving
• ? — single character: "tr?st" matches trust, tryst

Export is your backup tool. One Excel file holds every deck, so you can save it, edit it on a computer, or move your whole library to another device.

Tap "⬇ Export .xlsx". A single file named bible-cards-backup.xlsx downloads, containing all of your decks.

• A _Settings sheet — deck names, colors, order, and which tabs are open
• One sheet per deck, named after the deck (FBCC Bible Contest, Joy, …)
• Each deck sheet has columns: Reference, Scripture Text, Known

1. Tap "⬆ Import .xlsx".
2. Choose: Replace all cards or Add to existing cards.
3. Tap "Choose .xlsx File" and select your file.
4. Cards load immediately with a toast confirmation.

Multi-deck workbook (a file made by Export, or any workbook with multiple sheets) — every sheet becomes its own deck. Replace mode restores the whole library including names, colors and tab order.

Single sheet (a simple two-column file) — the cards go into the deck whose tab is currently active.

• Row 1 must be the header row
• Column A = reference, Column B = scripture text
• An optional Column C "Known" (TRUE/FALSE) is read if present
• Chinese characters, commas, quotes all handled correctly
• Empty rows are skipped automatically

1. Export on the first device.
2. Send the file over (AirDrop, email, or a cloud drive).
3. On the new device, tap Import → Replace all cards → choose the file.
4. All decks, colors, tab order, and Known marks are restored.

The quiz tests your memorization using speech recognition. The app reads the reference, you recite the verse from memory, and it scores your answer automatically.

The first time you start a quiz, your iPhone or browser will show a permission prompt like this:

✅ Always tap "Allow" — this is completely safe. The microphone is only used to hear your scripture recitation during the quiz. The app never records, stores, or transmits your voice anywhere. Without microphone access the quiz cannot work.

Tap the 🎯 button in the speech row to open the Quiz panel. The quiz always uses the deck whose tab is currently active — switch tabs first to quiz a different deck. Each deck keeps its own mastery progress.

1. 🔊 App speaks the reference aloud.
2. ⏳ Countdown ring animates — get ready to recite!
3. 🔔 BEEP — recording starts automatically.
4. 🎙️ Animated bars show the mic is listening.
5. Speak the scripture from memory.
6. 5 seconds of silence → auto-submits your answer.
7. 60 seconds maximum per card.
8. Result screen appears — split into two halves:

• Top half shows the correct scripture text
• Bottom half shows what you said (green = pass, red = fail)
• Banner shows PASSED or NOT YET with your % match score

• 🌱 Never-attempted cards — highest priority
• ❌ Recently wrong cards — high priority
• ⭐/🌟 Partially correct — normal priority
• 🏆 Mastered 3+ times — SKIPPED automatically

Fuzzy word matching compares your speech to the correct text:

• Score = words matched ÷ total correct words × 100%
• Minor speech-to-text errors may still pass at 80% accuracy
• No speech detected → counted as incorrect

• Score: X / Y correct with percentage
• Breakdown: Correct / Incorrect / Skipped / Newly Mastered
• List of all missed cards with correct scripture text
• 🔁 Retry Missed Cards — re-quiz only wrong answers
• 🎯 New Quiz — fresh quiz with smart card selection

You can change the app's color theme to suit your taste or your eyes. Tap the 🎨 button in the speech row to open the Appearance panel.

Tap any theme to apply it instantly. Your choice is saved and used every time you open the app.

• The background gradient and its soft glow
• All accent colors — text, dividers, buttons, the progress bar
• The frosted-glass card front picks up a faint tint of the theme
• Pop-up panels match the theme too

The reference side of each card is a translucent "frosted glass" panel, so the theme's colors glow gently through it. This is purely visual and does not affect speed on modern phones.