Getting Started
What is this app?
The Bible Scripture Flash Card app helps you and your family memorize scripture using digital flashcards. It comes pre-loaded with 48 official FBCC scripture memory verses and works on any device — iPhone, Android, tablet, or computer.
Opening the App
- Open your browser (Safari on iPhone, Chrome on Android).
- Go to charislogos.com
- The app loads immediately — no installation needed.
Add to Home Screen
iPhone (Safari):
- Tap the Share button (□↑) at the bottom of Safari.
- Tap "Add to Home Screen" → tap "Add".
- The gold cross icon appears on your home screen.
Android (Chrome):
- Tap the three-dot menu (⋮) in Chrome.
- Tap "Add to Home screen" → "Add".
Main Screen Layout
┌──────────────────────────────┐
│ Bible Scripture Flash Card │
│ COMMIT TO MEMORY │
│ v 2026.04.03 │
├──────────────────────────────┤
│ Card:1 Known:0 Total:48 🔥0 │
│ Progress ──────────── 0% │
├──────────────────────────────┤
│ ┌────────────────────────┐ │
│ │ ● Still Learning │ │
│ │ 2 Corinthians 5:17 │ │
│ │ Tap to reveal │ │
│ └────────────────────────┘ │
│ ← SWIPE TO NAVIGATE → │
│ [✗Still][✓Got It][✏️] │
│ [← Prev] [Next →] │
│ [🔊][📢 Speak All][⚙️][🎯] │
│ [+ Add][⬆ Imp][⬇ Exp][?] │
└──────────────────────────────┘
Compatible Devices
| Device | Browser |
|---|
| iPhone / iPad | Safari ✅ Chrome ✅ |
| Android / Pixel | Chrome ✅ Firefox ✅ |
| Mac | Safari ✅ Chrome ✅ |
| Windows | Chrome ✅ Edge ✅ Firefox ✅ |
| Chromebook | Chrome ✅ |
Flashcard Navigation
Navigating Between Cards
| Method | Action |
|---|
| 👆 Swipe left | Next card |
| 👆 Swipe right | Previous card |
| Next → button | Next card |
| ← Prev button | Previous card |
| → key | Next card (desktop) |
| ← key | Previous card (desktop) |
💡 Tip
The Card counter shows which card you're on. The deck wraps — going past the last card returns to card 1.
Flipping a Card
- 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.
🧠 Study Tip
Try to recall the verse BEFORE flipping — active recall is the most effective memorization technique!
Card Status Badge
Every card shows a status badge in the top-right corner:
| Badge | Meaning |
|---|
| ✓ Got It (green) | You've memorized this verse |
| ● Still Learning (red) | This verse needs more practice |
Got It / Still Learning
After flipping, three buttons appear:
| Button | What it does |
|---|
| ✓ Got It (green) | Marks Known. Streak +1. Badge turns green. Advances. |
| ✗ Still Learning (red) | Keeps in rotation. Streak resets. Badge turns red. |
| ✏️ Edit | Opens Edit Card panel to modify reference or text. |
Desktop: ↑ = Got It, ↓ = Still Learning (card must be flipped).
Editing & Deleting Cards
To edit: Flip card → tap ✏️ → edit reference or text → Save Changes.
To delete: Flip card → tap ✏️ → tap 🗑 Delete This Card → confirm.
⚠️ Note
Deletion cannot be undone. Re-add via + Add Card or re-import your Excel file to restore.
Progress Tracking
- 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.
Speech Features
Speech Buttons
| Button | What it does |
|---|
| 🔊 Speak | Loops the current Still Learning card continuously until ⏹ Stop |
| 📢 Speak All | Loops through ALL Still Learning cards sequentially; skips Got It cards |
| ⏹ Stop | Stops speech immediately |
| ⚙️ | Opens Speech Settings (voice, speed & pause) |
| 🎯 | Opens Pop Quiz (speech recognition quiz) |
How Speak Works
- App speaks the reference aloud.
- Pauses for your configured pause interval (time to recall!).
- Card flips to the back automatically.
- App speaks the full scripture text.
- Repeats from step 1 — loops the same card forever until ⏹ Stop.
💡 Swipe While Speaking
Swipe left or right (or tap Prev/Next) while Speak is running — speech stops instantly and the new card starts playing in the loop. Great for moving to the next verse when you feel ready!
💡 Note
Speak skips Got It cards. If all cards are Got It, it shows a celebration message.
How Speak All Works
- Builds a list of only STILL LEARNING cards.
- Starts at the closest Still Learning card to your current position.
- Screen jumps over Got It cards — speech and display both skip them.
- After the last Still Learning card, loops back and repeats forever.
- Tap ⏹ Stop at any time.
🎧 Usage Idea
Use Speak All while cooking, exercising, or driving. It keeps cycling through your Still Learning verses automatically!
Language Auto-Detection
- English cards → reads in English 🇺🇸
- Chinese cards → reads in Mandarin Chinese 🇨🇳
- Mixed deck → switches language card by card automatically
Setting Up Chinese Voice on iPhone
- Settings → Accessibility → Spoken Content → Voices.
- Tap Chinese → tap ⬇ next to Tingting or Meijia.
- Wait for download. Return to app.
Speech Settings ⚙️
- 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.
🧠 Study Tip
Set pause to 5–10 seconds to give yourself time to recall the verse before hearing the answer!
Adding & Searching Scripture
Adding a Card Manually
- Tap "+ Add Card".
- Type the reference (e.g., "Romans 8:28").
- Use Get Scripture, Search 🔍, or type text manually.
- Tap "Save Card".
✦ Get Scripture
Auto-fetches ESV verse text for any reference you type.
| Format | Example |
|---|
| Single verse | John 3:16 |
| Verse range | Romans 8:28-30 |
| Multiple verses | Psalm 119:9,11 |
| Entire chapter | Psalm 23 |
🌐 Note
Get Scripture requires internet. If offline, type the text manually.
🔍 Scripture Search
- Tap 🔍 next to the Reference field.
- Type a word or phrase. Select a scope (Entire Bible, OT, NT, or any book).
- Tap 🔎 Find — results appear with matched words highlighted in gold.
- Scroll down and tap "⬇ Load More Results" for more matches.
- Tap any result → reference and text fill in automatically.
- Tap "Save Card".
Search Wildcards
- * — any characters: "lov*" matches love, loved, loving
- ? — single character: "tr?st" matches trust, tryst
🌐 Note
Scripture Search is English ESV only. Chinese character searches will not return results.
Import & Export
⬆ Import Cards from Excel
- Tap "⬆ Import .xlsx".
- Choose: Replace all cards or Add to existing cards.
- Tap "Choose .xlsx File" and select your file.
- Cards load immediately with a toast confirmation.
Required Excel Format
Row 1: Reference | Scripture Text
Row 2: John 3:16 | For God so loved...
Row 3: Psalm 23:1 | The Lord is my...
Row 4: Romans 8:28 | And we know that...
- Row 1 must be the header row
- Column A = reference, Column B = scripture text
- Chinese characters, commas, quotes all handled correctly
- Empty rows are skipped automatically
💡 Tip
Import works completely offline — reads from your device with no internet needed.
⬇ Export Cards to Excel
Tap "⬇ Export .xlsx" → "scripture_cards.xlsx" downloads automatically. Open in Excel or Google Sheets to edit and re-import later.
💾 Backup
Export before importing a new set to keep a backup of your current cards.
Offline Capabilities
| Feature | Offline? |
|---|
| Viewing & flipping cards | ✅ Yes |
| Got It / Still Learning | ✅ Yes |
| Speak / Speak All | ✅ Yes |
| Import / Export Excel | ✅ Yes |
| Get Scripture | ❌ Needs internet |
| Scripture Search | ❌ Needs internet |
| Pop Quiz (speech) | ❌ Needs internet |
Pop Quiz 🎯
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.
Microphone Permission
The first time you start a quiz, your iPhone or browser will show a permission prompt like this:
"charislogos.com" Would Like to
Access the Microphone
[ Cancel ] [ Allow ]
✅ 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.
💡 If you tapped Cancel by mistake
Go to your iPhone Settings → Safari → scroll down to charislogos.com → Microphone → tap Allow. On Android, tap the 🔒 lock icon in Chrome's address bar → Microphone → Allow.
How to Start
Tap the 🎯 button in the speech row to open the Quiz panel.
Setup Options
| Setting | Description |
|---|
| Cards per Quiz | Use +/− to choose how many cards (1 to all) |
| Pause Before Recording | 1–15 seconds from reference to beep (get ready time) |
| Match Accuracy | 60–100% of words must match to count correct (default 80%) |
Quiz Flow per Card
- 🔊 App speaks the reference aloud.
- ⏳ Countdown ring animates — get ready to recite!
- 🔔 BEEP — recording starts automatically.
- 🎙️ Animated bars show the mic is listening.
- Speak the scripture from memory.
- 5 seconds of silence → auto-submits your answer.
- 60 seconds maximum per card.
- Result screen appears — split into two halves:
┌──────────────────────────────┐
│ ✅ PASSED 95% match│
│ John 3:16 │
├──────────────────────────────┤
│ ✦ Correct Scripture │
│ "For God so loved the world │
│ that he gave his only Son…" │
├──── 🎙 Your Answer ──────────┤
│ "For God so loved the world │
│ that he gave his only Son…" │
│ [ Next Card → ]│
└──────────────────────────────┘
- 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
💡 Tip
Tap "⏭ Skip This Card" anytime to skip. Skipped cards count as missed in the summary.
Mastery Levels
| Badge | Correct Answers | Quiz Status |
|---|
| 🌱 New | 0 | High priority |
| ⭐ Learning | 1 | Active |
| 🌟 Strong | 2 | Active |
| 🏆 Mastered | 3+ | SKIPPED in quiz |
⚠️ Note
A wrong answer reduces mastery by 1. Being Strong and getting it wrong drops you back to Learning.
Smart Card Selection
- 🌱 Never-attempted cards — highest priority
- ❌ Recently wrong cards — high priority
- ⭐/🌟 Partially correct — normal priority
- 🏆 Mastered 3+ times — SKIPPED automatically
How Answers Are Scored
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
End-of-Quiz Summary
- 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
Speech Recognition Support
| Device | Support |
|---|
| iPhone (Safari) | ✅ Works well |
| Android (Chrome) | ✅ Excellent |
| Desktop Chrome/Edge | ✅ Works well |
| Firefox | ⚠️ Limited |
| Offline | ❌ Needs internet |
🎙️ Tip
The app will ask for microphone permission the first time. Tap Allow. Speak clearly at a natural pace for best results.
Frequently Asked Questions
Q: Will my progress be saved if I close the app?
Yes! Everything saves automatically to your device's browser storage.
Q: What if I clear my browser history or cookies?
Clearing browser data resets cards and progress to the 48 default FBCC cards. Export first if you have custom cards you want to keep.
Q: Can I use the app on multiple devices?
Yes, but each device has independent progress. Use Export on one device and Import on another to transfer your card set.
Q: Can I add or edit cards in Chinese?
Yes — Chinese text displays and speaks correctly (with a downloaded Chinese voice). Scripture Search is English-only.
Q: Why does speech stop when my screen locks?
The app plays a silent audio loop to prevent this. Start Speak All before locking your screen.
Q: "Get Scripture" shows Network error — what do I do?
Check your internet. If it persists, the ESV API may be temporarily down. Try again shortly or type the text manually.
Q: How do I delete a card?
Flip the card → tap ✏️ → tap "🗑 Delete This Card" → confirm.
Q: How do I reset my quiz mastery data?
Open Quiz (🎯) → Setup screen → tap "Reset All Mastery Data". This only resets quiz history — your flashcard progress is unaffected.
Q: The quiz mic isn't working — what do I do?
Make sure you tapped Allow when the app asked for microphone permission. On iPhone, go to Settings → Safari → Microphone and allow access. Use Chrome on Android for best results.
Q: Can I use the app in a group Bible study?
Absolutely! Project it on a screen and navigate manually, or use Speak All to read verses aloud for the whole group.
Complete Feature List
Flashcard Core
| Feature | Description |
|---|
| Default Cards | 48 FBCC official scripture memory verses pre-loaded |
| Flip Card | Tap to reveal scripture; tap again to return to reference |
| Swipe Navigation | Swipe left/right to navigate |
| Card Index | Stats bar shows current card number at all times |
| Card Status Badge | ✓ Got It (green) or ● Still Learning (red) on every card |
| Got It / Still Learning | Track known verses; badge updates instantly; auto-advances |
| Edit Card ✏️ | Flip card → tap ✏️ to edit reference or scripture text |
| Delete Card | Remove any card permanently from the Edit panel |
| Progress Bar | Gold bar shows % Known cards in real time |
| Streak Counter | Consecutive correct answers counter |
| Version Number | App version shown in header (v 2026.04.03) |
Speech
| Feature | Description |
|---|
| Speak 🔊 | Loops current Still Learning card continuously; swipe to switch card mid-loop |
| Speak All 📢 | Loops through Still Learning cards only; forever |
| Pause Interval | 1–60 sec pause between reference and scripture text |
| Auto Language | Switches English/Chinese voice per card automatically |
| Screen Keep-Awake | Continues speaking when iPhone screen locks |
| Voice Picker | Choose from all voices on your device |
| Speed Slider | Reading speed 0.4× to 1.6× |
| Test Voice | Hear sample before committing to voice/speed |
Pop Quiz 🎯
| Feature | Description |
|---|
| Speech Recognition | Listens to your recitation and converts to text |
| Fuzzy Matching | 60–100% configurable accuracy threshold |
| 60s Max / 5s Silence | Auto-submits after silence or time limit |
| Mastery Levels | 🌱→⭐→🌟→🏆 per card (3 correct = mastered/skipped) |
| Smart Selection | Weighted toward new/wrong cards; skips mastered |
| Quiz Summary | Score, missed cards list, retry option |
| Retry Missed | Instantly re-quiz only wrong answers |
Adding & Searching
| Feature | Description |
|---|
| Add Card | Add custom cards with reference and text |
| Get Scripture | Auto-fetches ESV verse text |
| Scripture Search | Search ESV Bible by word/phrase with scope |
| Search Highlighting | Matched words highlighted in gold |
| Load More | Load more results 10 at a time |
| Wildcard Search | Use * and ? in search phrases |
Import / Export / Platform
| Feature | Description |
|---|
| Import Excel | Load cards from .xlsx (replace or append) |
| Export Excel | Download all cards as .xlsx |
| Auto-Save | All data saved to device automatically |
| Home Screen Install | Add to iPhone/Android home screen |
| Cross-Device | iPhone, Android, iPad, Mac, Windows, Chromebook |
| Offline Core | Cards, speech, import/export without internet |
| Keyboard Shortcuts | Desktop navigation and marking via keyboard |
Keyboard Shortcuts (Desktop)
| Key | Action |
|---|
| Space / Enter | Flip card |
| → | Next card |
| ← | Previous card |
| ↑ | Got It (card must be flipped) |
| ↓ | Still Learning (card must be flipped) |