▶️

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
  1. Open the app and you'll land on the Today page — your daily dashboard showing progress, streaks, quests, and a daily verse.
  2. Tap "Continue Your Journey" to start your first lesson. Lessons are interactive and take about 3-5 minutes each.
  3. After completing a lesson, you'll earn Manna (XP) and see your Daily Bread meter fill up.
  4. Explore the side menu to discover Quests, Lumen study tools, Reading Plans, and more.
  5. 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
ActionTokensCost
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 tokensFREE
Offline answers (local)0 tokensFREE
"Ask Lumen AI" pill (navigation)0 tokensFREE
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)
UsersMsgs/user/dayMonthly Cost
1003$3–7
1,0003$30–70
10,0003$300–700
50,0003$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:

  1. Offline Engine — Checks local database before any API call
  2. Query Router — Routes to Haiku (~$0.001) or Sonnet (~$0.01) based on complexity
  3. AI Service — Swift actor with SSE streaming, prompt caching, structured system prompts
  4. 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