Knowledge Center
Everything you need to know about Gospify
Getting Started
Begin your journey with Gospify
Welcome to Gospify
Gospify is your daily companion for studying Scripture. Designed to help you build a consistent, meaningful Bible study habit, the app combines bite-sized lessons, memorization tools, and a rich study companion called Lumen — all woven together with a gentle progression system that rewards your faithfulness.
Think of Gospify as a seminary in your pocket: structured enough to guide you, flexible enough to meet you where you are, and beautiful enough to make the journey a joy.
Your First Steps
- Open the app and you'll land on the Today page — your daily dashboard showing progress, streaks, quests, and a daily verse.
- Tap "Continue Your Journey" to start your first lesson. Lessons are interactive and take about 3-5 minutes each.
- After completing a lesson, you'll earn Manna (XP) and see your Daily Bread meter fill up.
- Explore the side menu to discover Quests, Lumen study tools, Reading Plans, and more.
- Come back tomorrow to keep your streak alive!
Navigating the App
Tap the menu icon in the top-left corner to open the side menu. From there you can access:
- Today — Your daily dashboard and progress
- Path — Your lesson journey through Scripture
- Quests — Daily and weekly challenges
- Ask Lumen — Your AI-powered study companion
- Reading Plans — Guided multi-day study paths
- Library — Browse all available content
- Shop — Spend your earned Mites on themes and badges
- Knowledge Center — Help and info
- Settings — Customize your experience
Choosing Your Tradition
Catholic, Protestant, or Both?
Why Choose a Tradition?
Gospify is built to serve all Christians. When you select a tradition in Settings, the app tailors your experience:
- Lesson content may include tradition-specific theology and practices
- Cross-references in Lumen highlight denomination-relevant insights
- Some units are tradition-specific, covering topics unique to your faith journey
Choosing a tradition doesn't limit you — it enriches your study by focusing on what matters most to your walk with Christ. You can change your tradition at any time in Settings.
Catholic Tradition
The Catholic tradition emphasizes:
- The authority of Scripture alongside Sacred Tradition and the Magisterium
- Seven sacraments as means of grace
- Devotion to Mary and the saints as intercessors
- The Real Presence of Christ in the Eucharist (transubstantiation)
- A rich liturgical calendar with feast days, seasons of Lent and Advent
- The Deuterocanonical books (Tobit, Judith, Wisdom, Sirach, Baruch, 1 & 2 Maccabees)
In Gospify, choosing Catholic includes units on the sacraments, Marian theology, Church history from the apostolic age, and liturgical practices.
Protestant Tradition
The Protestant tradition emphasizes:
- Sola Scriptura — Scripture alone as the ultimate authority
- Sola Fide — Justification by faith alone
- Sola Gratia — Salvation by grace alone
- The priesthood of all believers
- Two ordinances: Baptism and the Lord's Supper
- The 66-book Protestant canon of Scripture
In Gospify, choosing Protestant focuses on Reformed theology, evangelical practices, the five Solas, and the history of the Reformation.
Both (Combined)
Choosing "Both" gives you the fullest Gospify experience:
- Access ALL lesson units — both Catholic-specific and Protestant-specific
- Cross-references show insights from multiple theological perspectives
- Holy day celebrations include both traditions
- A broader understanding of how different Christians interpret the same Scripture
We encourage this option for anyone who values learning from the whole Body of Christ.
Features Guide
Everything the app offers
Today Page
The Today page is your daily hub. It shows:
- A time-aware greeting that changes throughout the day
- A context banner with your most important status update
- A "Continue Your Journey" button to resume your current lesson
- Upcoming holy days and liturgical events
- Your Daily Bread progress ring showing Manna earned today
- A preview of your active quests
- A daily verse that changes each day (365 unique verses!)
- Evening Vespers (available after 8 PM) for quiet reflection
Path (Lesson Journey)
The Path is your structured journey through Scripture, organized into units with multiple lessons. Lessons include interactive exercises like fill-in-the-blank, multiple choice, verse ordering, and matching. Each lesson takes about 3-5 minutes and earns you Manna based on performance.
You can earn up to 3 stars per lesson. Lessons use the World English Bible (WEB) translation, which is in the public domain.
Ask Lumen (Study Companion)
Lumen is your comprehensive Bible study companion. It includes:
- Topics — Explore 30+ biblical themes like Grace, Faith, Love, and Redemption
- Cross-References — Deep-dive into verse context, historical background, and related passages
- Word Studies — Learn Greek and Hebrew origins with audio pronunciation
- AI Chat — Ask any Bible question (uses daily credits)
- Flashcards — SM-2 spaced repetition quiz system
- Bible Navigator — Browse content by book of the Bible
- Saved Verses — Bookmark your favorites
- Collections — Themed verse groupings
- Timeline & Maps — Biblical history and geography
- Reading Plans — Guided multi-day study paths
- Verse Comparison — KJV, NIV, ESV, NASB side-by-side
- Reflections — Personal study journal
Every topic, verse, and word you explore earns +2 Manna!
AI-Powered Lesson Features
Gospify integrates AI directly into the learning experience:
- "Why Was I Wrong?" — After an incorrect answer, get an AI explanation of the correct answer. Costs 1 AI credit.
- Reflection Follow-Up — After saving a reflection, Lumen generates a thoughtful follow-up question. Completely free.
- "Ask Lumen AI" Pills — Teaching cards include a teal button that takes you to Lumen's chat with the verse pre-filled. No credit spent until you send a message.
Quests
Quests are daily and weekly challenges that reward you with Mites (gems). Daily quests reset at midnight and include goals like "Earn 20 Manna today" or "Complete 2 lessons." Claim your rewards before they reset!
Reading Plans
Guided multi-day study paths focused on specific themes:
- Grace in 7 Days
- Names of God (5 Days)
- Fruit of the Spirit (9 Days)
- Key Words of Paul (7 Days)
- Psalms of Comfort (5 Days)
Completing a day earns +3 Manna. Finishing an entire plan earns a +10 bonus!
Evening Vespers
After 8 PM, an Evening Vespers card appears on your Today page. Vespers is a brief, contemplative Scripture experience with a calming reading and reflection prompt. Completing Vespers earns +5 Manna.
The tradition of evening prayer dates back to the early church and is observed across Christian denominations.
Shop
The Shop is where you spend earned Mites on cosmetic items: themes, badges, and special seasonal items. The Shop is purely cosmetic — there are no pay-to-win mechanics. Every feature in Gospify is available to all users for free.
Manna & Progress
XP, levels, and daily goals explained
What is Manna?
Manna is your spiritual experience points (XP). Earned through nearly every activity:
- Completing a lesson: +5 Manna
- Reviewing a memorized verse: +2
- Exploring a Lumen topic/verse/word (first time): +2
- Flashcard correct answer: +1
- Completing a flashcard set: +5 bonus
- Reading plan day: +3
- Completing a full reading plan: +10 bonus
- Evening Vespers: +5
“Give us today our daily bread.” — Matthew 6:11
Daily Bread (Daily Goal)
Your Daily Bread is your daily Manna target (default: 20). The progress ring fills as you earn Manna. Reaching 100% counts as a study day for your streak. Choose 10, 20, 30, or 50 Manna in Settings.
Levels & Ranks
As you accumulate Manna, you level up and earn spiritual ranks. Each rank comes with a unique icon and Scripture verse. Your total Manna earned across all time determines your level.
Streaks & Goals
Consistency, achievements, and milestones
How Streaks Work
A streak counts consecutive days you've studied Scripture. Each day you reach your Daily Bread goal (or complete at least one lesson), your streak increments. Milestones at 7, 30, and 100 days unlock achievements and bonus rewards.
“Let us not become weary in doing good, for at the proper time we will reap a harvest if we do not give up.” — Galatians 6:9
Grace Period & Sabbath
If you miss a day, you have a brief grace period to study and save your streak. You can also set a Sabbath rest day in Settings — on your chosen day, your streak is preserved without studying.
“Remember the Sabbath day, to keep it holy.” — Exodus 20:8
Achievements
Achievements are milestone badges for significant accomplishments: First Light (first lesson), Faithful Flame (7-day streak), Word Scholar (10 word studies), Quiz Master (100% on a quiz), Plan Completer, and many more. Permanently earned — they'll always be on your profile.
Lumen In-Depth
Advanced study tools explained
AI-Powered Chat
Ask Lumen any Bible question. Lumen is prompted to explain verses, theology, and church history; respect both traditions; include verse references; never fabricate verses; and present multiple perspectives fairly.
Your conversations are private and not stored on any server.
Flashcards & Spaced Repetition
The flashcard system uses SM-2 spaced repetition — the same algorithm used by medical students. Words you get right are scheduled at increasing intervals (1, 3, 7 days, etc.). Words you miss come back sooner. Optimal long-term retention with less wasted time.
Verse Comparison
See how KJV, NIV, ESV, and NASB render the same passage. Helps you see nuances in translation choices and deepen understanding of the original meaning. Access it via "Compare" on any cross-reference card.
Timeline & Maps
The Timeline presents key biblical events chronologically — from Creation through the early Church. Maps show important biblical locations with descriptions and manuscript context. Both are fully offline.
Audio Pronunciation
Word study cards include audio pronunciation using Greek (el-GR) or Hebrew (he-IL) text-to-speech voices. Speech rate is slowed to 60% for learning clarity. Verse cards also have "read aloud" buttons.
Denomination Insights
Cross-reference cards show tradition-specific notes when available, helping you understand how Catholic and Protestant scholars approach the same passages differently. Set your preference in Settings.
Lumen AI & Costs
How AI credits work and what they cost
How AI Credits Work
Lumen AI gives you 5 free AI credits per day. Each credit lets you send one message to the AI chat, or use one "Why was I wrong?" explanation. Credits reset at midnight every day.
Most users use 2-3 credits per day. All other Lumen features (topics, cross-references, word studies, flashcards, reading plans, collections, maps, timeline) are always unlimited and free.
Cost Per Action
| Action | Tokens | Cost |
|---|---|---|
| Ask Lumen AI (simple) | ~330 tokens | ~$0.001 |
| Ask Lumen AI (deep theology) | ~1,700 tokens | ~$0.01 |
| "Why was I wrong?" | ~330 tokens | ~$0.001 |
| Reflection follow-up | ~330 tokens | FREE |
| Offline answers (local) | 0 tokens | FREE |
| "Ask Lumen AI" pill (navigation) | 0 tokens | FREE |
Smart Model Routing
Haiku (lightweight, ~80% of questions): Used for simple, factual questions. Fast, accurate, and costs ~10x less than the advanced model.
Sonnet (advanced, ~20% of questions): Used for complex theological questions, comparative analysis, and multi-verse interpretation. Triggers automatically for complex queries.
This routing happens automatically — you don't need to choose.
Offline-First Answers
Before calling the AI, Lumen checks its built-in local database of 30+ topics, 30+ cross-references, and 20+ word studies. If your question matches, it answers instantly — no internet needed, no credit spent. This eliminates an estimated 40-60% of API calls.
Prompt Caching
The system prompt (Lumen's instructions) is cached server-side after the first message, cutting repeated costs by up to 90%. This is a behind-the-scenes optimization — same quality, lower cost.
Estimated Monthly Cost (Developer)
| Users | Msgs/user/day | Monthly Cost |
|---|---|---|
| 100 | 3 | $3–7 |
| 1,000 | 3 | $30–70 |
| 10,000 | 3 | $300–700 |
| 50,000 | 3 | $1,500–3,500 |
These are real numbers — Gospify is fully transparent about the cost of running AI features.
❤️ A Note from the Developer
Gospify is completely free. There are no ads, no paywalls, no premium tiers, and no data selling. Every feature — including AI-powered study — is available to everyone at no cost.
But AI isn't free to run. Every time you ask Lumen a question, it costs real money in API fees. The developer bears this cost personally because the mission matters more than profit: making Scripture accessible to everyone.
Please be mindful with your AI credits. Each message, however small, has a real cost behind it. Use Lumen's offline features as your primary study tools — they're unlimited, instant, and incredibly rich. Save AI chat for the moments when you truly need a deeper, personalized answer.
Your thoughtfulness helps keep Gospify free for everyone.
“Each of you should use whatever gift you have received to serve others, as faithful stewards of God's grace in its various forms.” — 1 Peter 4:10
Under the Hood
How Gospify is built
Architecture Overview
Gospify is a native iOS app built entirely in Swift and SwiftUI, targeting iOS 17+. It uses a single-source-of-truth state management pattern with Apple's @Observable macro. One central AppState object holds all user data, preferences, and computed properties.
Project configuration uses XcodeGen (project.yml) for deterministic project generation.
Offline-First Design
- All 100+ lessons bundled locally in curriculum.json
- Entire Lumen study library embedded in the app
- Flashcards, reading plans, collections, timeline, maps — all local
- Daily verses pre-computed algorithmically
- Data persisted using UserDefaults with Codable wrapper
Only Lumen AI Chat requires internet. Even then, offline-first engine checks local data first.
The Design System
Colors: Teal (primary), amber (accent), burgundy (emphasis), parchment (background) — ancient manuscripts with modern clarity.
Typography: Georgia serif for display, system rounded for body. Type scale from 10pt to 28pt.
Spacing: 8-point grid system (xxs through xxxl).
Motion: Three animation curves (fast, mid, slow). Staggered entrance animations.
Components: .gospifyCard(), GospifyOrnamentalDivider, ProgressRing, custom button styles.
AI Integration Architecture
Four layers working together:
- Offline Engine — Checks local database before any API call
- Query Router — Routes to Haiku (~$0.001) or Sonnet (~$0.01) based on complexity
- AI Service — Swift actor with SSE streaming, prompt caching, structured system prompts
- Credit Gate — Enforces 5/day limit, confirmation dialog, reset countdown
Security & Privacy by Design
- No server — No backend database to breach
- No tracking — Zero analytics or telemetry
- API key isolation — Excluded from version control
- Minimal API data — No personal info in API requests
- Sign in with Apple — Privacy-preserving authentication
Accessibility
Gospify for everyone
VoiceOver & Dynamic Type
Gospify works with VoiceOver with descriptive labels on all interactive elements. The app respects system font size settings (Dynamic Type) and remains usable at all text sizes.
Audio & Haptic Features
Read-aloud buttons on verse cards, Greek/Hebrew pronunciation, haptic feedback (toggleable), and sound effects (toggleable). All audio features are supplementary — the app is fully usable without sound.
Reduced Motion
When "Reduce Motion" is enabled in your iPhone's accessibility settings, Gospify minimizes animations for a calmer experience.
About Gospify
Our mission and story
Our Mission
Gospify exists to make daily Scripture study accessible, engaging, and beautiful. We believe the Bible is a living text that speaks to every generation, and building a daily habit transforms lives.
“Your word is a lamp to my feet, and a light for my path.” — Psalm 119:105
Meet the Developer
Gospify was created by Honorius M. Neogy, a passionate developer and designer driven by faith and a love for technology. Built from the ground up — curriculum, lessons, design system, and every line of code.
Gospify is more than an app — it's a labor of love, built with the conviction that technology can bring people closer to God's Word.
Credits & Acknowledgments
- Bible Text — World English Bible (public domain)
- AI Responses — Powered by Anthropic Claude (Haiku & Sonnet)
- App Framework — Swift & SwiftUI for iOS 17+
- Project Tooling — XcodeGen
- Authentication — Sign in with Apple
- Cloud Sync — Apple CloudKit
- Icons — SF Symbols by Apple