Feature Reference — v3.0

Resonate AI
Documentation

A complete guide to every feature, capability, and experience inside the world's most advanced AI-powered Bible study platform.

Overview

Resonate AI is a digital sanctuary — an AI-powered Bible study platform that generates personalized, seminary-quality devotionals based on how you're feeling, what you're going through, and where you are in your faith journey.

Unlike generic "verse of the day" apps, Resonate listens to your heart and responds with deep, theologically-grounded scripture analysis, historical context, original-language insights, personal application, and a hand-crafted prayer — all in seconds. It also tracks your entire Bible reading progress, lets you chat with an AI theologian about any chapter, and connects you with a community of believers through a real-time Prayer Wall.

Our Promise Resonate will never sell your data. Resonate will never show you advertisements. Resonate will never put the Word of God behind a paywall. Your spiritual journey is sacred.

AI Study Generator

Mood-based devotionals

📖

Bible Tracker

66 books, 1,189 chapters

💬

AI Theologian Chat

Ask about any chapter

🙏

Prayer Wall

Community intercession

🏆

Badges & Achievements

Earn AI-generated badges

👥

Community Hub

Leaderboards & activity

📄

PDF Downloads

Save & print studies

📈

Journey Dashboard

Streaks, stats, growth

Verse Treasury

Save favorite scriptures

CORE

AI Study Generation

Page: index.php

The heart of Resonate. Tell the AI how you're feeling, what's on your heart, or what you're going through, and it will generate a complete, personalized Bible study in seconds — with scripture, historical context, theological analysis, personal application, and a prayer crafted specifically for you.

INPUT What You Provide
ParameterTypeDescription
mood string How you're feeling. Freeform text — e.g. "I'm feeling overwhelmed at work and disconnected from God" or "I'm grateful for a breakthrough." This is the primary input that drives the entire study.
duration integer Study length in minutes. Options: 5, 15, 30, or 60. Longer studies include more scripture, deeper historical context, and additional reflection questions.
quick_mood string Optional one-click shortcuts: Weak, Anxious, Grateful, or Seeking. Each pre-fills a curated mood prompt.

Study Anatomy

Every generated study contains these sections, rendered in a beautiful, scroll-driven layout:

OUTPUT Generated Study Structure
// Every study contains: { "title": "A Shelter in the Storm", "theme": "Finding peace when life feels uncontrollable", "main_passage_ref": "Psalm 46:1-11", "verses": [ ...full verse text with references ], "rewind": "A narrative retelling of the biblical context — who wrote it, when, why, and the historical circumstances surrounding the passage.", "rethink": "Application of the scripture to YOUR specific mood and situation. How this ancient text speaks directly into your modern life.", "reflection_points": ["Consider how...", "Notice that...", "Ask yourself..."], "engagement_questions": { "heart": "What resonated most deeply with you?", "will": "What is one concrete step you can take today?" }, "prayer": "A first-person prayer crafted from the scripture and your emotional state — words to pray back to the Father when you can't find your own." }
Interactive Engagement Each study includes two open-ended journaling questions. Your written responses are saved permanently and can be revisited from the Study Archives — building a spiritual journal over time.

Example: Study preview

Psalm 46:1-11
A Shelter in the Storm
A narrative retelling of the biblical context — who wrote it, when, why, and the historical circumstances surrounding the passage.

The Mood Engine

Resonate's AI doesn't just pick random verses. It analyzes the emotional tone and semantic meaning of your input to find scripture that specifically addresses what you're going through. Feeling anxious? You won't get Levitical law — you'll get Psalm 23, Philippians 4:6-7, or Matthew 6:25-34. Feeling grateful? You'll receive passages of praise and thanksgiving.

The engine also considers your reading history to avoid repeating the same passages, ensuring every study feels fresh and progressive.

"Surprise Me" Mode

Don't know what you need today? Hit "Surprise Me" and Resonate will select a passage you haven't read yet from across the entire Bible, generate a unique study around it, and introduce you to scripture you may never have explored on your own. This mode intelligently avoids chapters you've already completed in the Bible Tracker.

Save & Print Studies as PDF

Every study you generate can be saved as a beautifully formatted PDF document or printed directly from the browser. Access this feature from the My Studies tab in Account Settings, where each study has a dedicated download button.

OUTPUT PDF Contents
SectionDescription
HeaderStudy title, scripture reference, theme, date, and your name.
ScriptureAll verses covered in the study, with individual references.
RewindThe full narrative retelling of the biblical story.
RethinkThe personal application section connecting scripture to your life.
ReflectionReflection points and engagement questions with labels.
PrayerThe AI-crafted prayer tailored to your situation.
JournalYour personal written responses to the study questions.

Save as PDF

Downloads a formatted PDF file directly to your device. Individual studies or all studies at once. Files are named with the scripture reference and date for easy organization.

Print

Opens your browser's native print dialog for physical printing. The layout is optimized for A4 paper with proper page breaks between studies, clean typography, and a gold accent design.

CORE

Bible Tracker

Page: bible_tracker.php

A comprehensive visual tracker covering all 66 books and 1,189 chapters of the Bible. Each book is displayed as a grid of chapter "runes" that light up gold as you progress. Chapters are automatically marked as read when you complete AI studies, or you can manually mark them in the tracker itself.

Completion Tracking

Visual progress across Old & New Testament. Percentage completion, chapters remaining, and a real-time progress bar.

Personal Notes

Write and save private notes on any chapter. Your annotations are stored permanently and displayed when you revisit the chapter.

Verse Favoriting

Click the heart on any verse while reading to save it to your Treasury. Favorites appear on your Journey Dashboard.

Chapter Reader

Click any chapter in the tracker to open a full chapter reader modal. The text is displayed verse-by-verse with clean typography. Each verse has a heart icon for instant favoriting. The chapter content is cached locally after first load for instant subsequent access.

AI Theological Chat

Every chapter in the Bible Tracker and every generated study includes a floating AI chat widget. Ask questions about what you're reading and receive context-aware, theologically-grounded answers. The AI knows which chapter or study you're viewing and uses it as context for its responses.

EXAMPLE Chat in Action
Y
"Why did God ask Abraham to sacrifice Isaac if He already knew the outcome?"
R
"The binding of Isaac (the Aqedah) in Genesis 22 wasn't a test of information — God already knew Abraham's heart. It was a test of demonstration. Abraham needed to experience his own willingness to surrender, and through that act, God established the typological pattern that would later point to His own sacrifice of His Son..."

Reading Goals

Set personal Bible reading goals with target dates. Goals appear in your tracker sidebar and can be marked complete or deleted. Examples: "Read all of Psalms by Easter" or "Finish the Gospels this month." A simple accountability system to keep your reading on track.

CORE

Journey Dashboard

Page: journey.php

Your personal spiritual command center. The Journey Dashboard aggregates your entire Resonate experience into a single, beautiful view.

Dashboard Metrics
MetricDescription
total_timeCumulative minutes spent in Bible study across all completed sessions.
studies_completedTotal number of AI-generated studies you've finished.
chapters_readUnique Bible chapters marked as read (out of 1,189). Merges both AI study chapters and manually tracked chapters.
bible_completionPercentage of the entire Bible you've read, displayed as a progress bar.
daily_verseA random verse from your saved favorites displayed as an inspirational header.

The dashboard also includes your paginated Study History (with delete capability) and your Verse Treasury — a beautiful grid of every verse you've saved across the platform.

CORE

Study Archives

Page: history.php

Every study you generate is permanently saved and searchable. The Archives page displays your studies as elegant cards showing the title, scripture reference, theme, mood, duration, and date. Click any card to re-read the full study with all your journal entries preserved.

Searchable Real-time client-side search lets you filter studies by title, theme, mood, or scripture reference. Type "anxiety" to find every study you've generated about worry. Type "Romans" to find every study from that book.
CORE

Badges & Achievements

Page: badges.php

Resonate features a comprehensive achievement system to celebrate your spiritual milestones. As you read through the Bible, complete studies, and build streaks, you'll unlock beautifully crafted badges — each one generated by AI with unique artwork inspired by the accomplishment it represents.

AI-Generated Badge Art Every badge in Resonate features a unique, ornate gold shield design generated by Google Gemini's image model. Each badge incorporates imagery and symbolism specific to the book or achievement it represents — making every unlock feel truly special.

Badge Types

SCHEMA Badge Requirement Types
TypeRequirementExample
books Complete every chapter in the specified book(s) of the Bible. {"type":"books","book_list":["Genesis"]}
chapters Read a specific number of total chapters across the Bible. {"type":"chapters","count":100}
studies_count Complete a certain number of AI-generated studies. {"type":"studies_count","count":50}
streak Maintain a consecutive daily study streak. {"type":"streak","days":30}

There's a badge for completing every book of the Bible — all 66 books, from Genesis to Revelation. Each book badge features unique AI-generated artwork reflecting the themes, stories, and imagery of that specific book.

Badges Page

View all available badges in a gallery. Earned badges appear in full color; unearned badges are grayed out. Hover any badge to see its requirements and your live progress.

Journey Display

Your earned badges appear on your Journey Dashboard in an expandable container. Click to see your full badge collection at a glance.

Automatic Checking

Badge requirements are checked automatically after every study generation, study completion, and chapter read. You never need to manually claim a badge.

Example: Badge cards & requirements

Genesis
Complete every chapter in Genesis
50 Studies
Complete 50 AI-generated studies
30-Day Streak
Study 30 days in a row

Example: Unlock toast (global announcement)

Sarah earned the Genesis badge.

Unlock Notifications

When you earn a badge, two things happen simultaneously:

Personal Celebration

A full-screen celebration popup appears with the badge artwork, the badge name, and a congratulatory message. It animates in with a glowing effect and stays visible for 15 seconds (or until you dismiss it).

Global Announcement

A toast notification slides in on every connected user's screen, announcing your achievement to the community. It shows your name, the badge artwork, and the badge name — celebrating your milestone with the entire Resonate family.

COMMUNITY

Prayer Wall

Page: prayer_requests.php

The Prayer Wall is Resonate's community feature. Believers can submit prayer requests and the entire community can respond, letting them know they're being lifted up in prayer. It's a simple but powerful tool for intercessory support.

SUBMIT Prayer Request
FieldTypeDescription
namestringYour display name — hidden when posting anonymously.
prayer_requesttextWhat you'd like the community to pray for.
Post AnonymouslytoggleWhen checked your prayer appears as Anonymous Believer on the wall. Your real identity is never stored or shown publicly.
RESPONSE Prayer Card

Each prayer request displays the requester's name (or Anonymous Believer), the prayer text, time elapsed since submission, and a "Pray" button. Clicking it adds your name to the list of responders and increments the prayer count. The requester can see exactly how many people are lifting them up.

The wall shows the current week's requests, paginated, with running statistics on total requests and total prayers offered.

PRIVACY Anonymous Prayer Requests

Some believers may want to share a prayer need without revealing their identity to the community. Resonate fully supports this while still keeping you connected.

Per-Request Toggle

In the submission form, tick Post Anonymously before submitting. Your name field is hidden and the prayer appears on the wall as Anonymous Believer. Default is off (name is shown).

Account-Level Default — Account Settings → Profile

In Account Settings under the Profile tab, toggle Post prayer requests anonymously by default. When enabled, the anonymous checkbox in the prayer form will be pre-ticked every time you open it — you can still uncheck it for individual requests. Default is off.

Admin Visibility

Site admins can always see who posted a prayer request (for moderation), but that information is never surfaced to the public community. Anonymous prayers are clearly marked in the admin panel.

Live Prayer Notifications

A background scanner runs on every page of the app, polling for new prayer requests every 5 seconds. When a new request is posted, a notification slides in from the bottom-right corner of the screen. Clicking the notification opens a modal with the full request details and a button to respond. If you're not logged in, clicking the notification will prompt you to sign in first.

Example: Prayer card on the wall

Maria
Please pray for my family as we navigate a difficult season. We need wisdom and peace.
2 hours ago
Pray

Example: Live notification (bottom-right)

New prayer request
Maria requested prayer — tap to view and respond.
COMMUNITY

Community Hub

Page: community.php

The Community Hub is the central gathering place for Resonate believers. It brings together achievement activity, leaderboards, shared studies, and community milestones into a single, engaging page that celebrates the collective spiritual journey.

Badge Leaderboard

The top 10 users ranked by total badges earned are displayed in a live leaderboard. Each entry shows the user's name, avatar, badge count, and their rank. It's a friendly way to encourage continued Bible reading and study completion across the community.

Badges This Week

A dedicated section lists all badges earned across the platform in the past 7 days, showing who earned what and when. Stay inspired by the progress of fellow believers.

Community Stats

Running totals of community-wide metrics: total believers, total badges earned, and total prayers offered — showing the collective impact of the Resonate community.

Social & News Feed

A filterable feed combines faith-related news articles and YouTube videos in one stream. Filter by “All,” “YouTube,” or “News” to browse content. The same feed powers the web Community Hub and mobile apps via get_community_news.

Shared Studies

When you complete a study, you can choose to Share publicly. Shared studies appear on the Community Hub in a grid. Anyone can:

  • Heart a study — a heart count is shown on each card; you can toggle your heart on or off.
  • Save a study — add it to your saved list for quick access later (logged-in users).
  • Copy link — copy a public URL to send the study to someone else (e.g. view_study.php?id=123).

On the study view page (view_study.php), the same heart, save, and copy-link actions are available when viewing a shared study you don’t own. Heart and save states sync across the hub and the study page.

PLANS

Free vs Premium

Resonate offers a generous free tier because we believe the Word of God should never be gated. Premium unlocks unlimited access for those who want to go deeper.

Feature Free Premium
AI Bible Studies 2 per day Unlimited
AI Chat Messages 25 per day Unlimited
Saved Studies 50 max Unlimited
Favorite Verses 25 max Unlimited
Bible Tracker Full access Full access
Prayer Wall Full access Full access
Journey Dashboard Full access Full access
Reading Goals Full access Full access
Study Archives Full access Full access
Badges & Achievements Full access Full access
Community Hub Full access Full access
PDF Downloads Full access Full access
Profile Picture Full access Full access
Data Export Full access Full access
Pricing Free forever Pay what you want (min $1/mo)
Pay What You Want Premium pricing is completely up to you. Choose any monthly amount starting at $1. There are no tiers, no feature gates between premium levels — every premium member gets the same unlimited access regardless of what they pay.
ACCOUNT

Account Settings

Page: account_settings.php

A full-featured account management dashboard organized into six tabs: Profile, Appearance, Membership, Security, My Studies, and Danger Zone. Everything you need to customize your experience, manage your subscription, and own your data.

Appearance & Light/Dark Mode

The Appearance tab lets you control how Resonate looks. Choose Light or Dark theme; your preference is saved and applied across the entire site (and synced to mobile if you use the app). You can also set a custom accent color that replaces the default gold for buttons, links, and highlights. Font size overrides for headings and body text are available for accessibility. The theme toggle is also available in the main navigation so you can switch quickly without opening settings.

OptionDescription
ThemeLight or Dark. Dark is the default; light uses cream backgrounds and maroon/gold accents.
Accent colorOptional hex color for links, buttons, and focus states (replaces default gold).
Font sizesOptional overrides for H1, H2, H3, and body text (stored in users table, applied via CSS variables).

Profile Tab

Upload a custom profile picture, update your display name, community display name, and visibility on the Community page. Quick stats show your total studies, badges earned, and current streak at a glance.

Appearance Tab

Light/dark theme toggle, optional accent color, and optional font size overrides. Preferences sync across devices and are applied site-wide.

Membership Tab

View your plan status, monthly cost, and next payment date (fetched live from Stripe). Upgrade to premium, or cancel your subscription instantly — no hoops to jump through.

Security Tab

Change your password (with current-password verification), update email, and manage linked sign-in methods (Google, X, Discord, Facebook, NEUS). Passwords are hashed with bcrypt.

My Studies Tab

Browse all your completed studies with stats on total time studied, chapters read, and study count. Download individual studies as PDF or download all studies at once.

Danger Zone Tab

Export all your data as a comprehensive JSON file, or permanently delete your account. Deletion cascades across all tables and cancels any active Stripe subscription.

Profile Picture

Personalize your Resonate presence with a custom profile picture. Upload any JPG, PNG, GIF, or WebP image up to 2MB. Your photo appears throughout the platform — in the navigation bar, on the community page, in badge leaderboards, and wherever your identity is displayed.

UPLOAD Profile Picture
DetailDescription
formatsJPG, PNG, GIF, WebP
max_size2 MB
upload_methodClick the avatar area or the "Upload Photo" button. Preview appears instantly before upload completes.
fallbackIf you prefer, click "Generate Avatar" to create a unique letter-based avatar from your name.

Data Export & Account Deletion

You own your data. Export everything — your profile, studies, journal responses, Bible tracker progress, favorite verses, and badges — as a single JSON file. Or, if you choose to leave, permanently delete your entire account with one click.

Complete Deletion Account deletion is thorough and permanent. It removes your data from all tables (studies, tracker, stats, favorites, badges, prayer requests, announcements, blog reads), cancels any active Stripe subscription, destroys your session, and redirects you home. There is no undo.
ACCOUNT

NEUS Login & Proof Creation

Resonate integrates with NEUS (api.neus.network), a Web3 identity and verification layer. You can link your NEUS identity in Account Settings → Security. Once linked, every study you generate can be cryptographically signed with a proof that attests you created it — verifiable on-chain without exposing your personal data.

Link NEUS

In Security tab, connect your NEUS (wallet) identity. Your Resonate account is then tied to that identity for proof creation. You can unlink at any time.

Study Proofs

After each study is generated, if NEUS is linked, the app creates an ownership proof and attaches it to the study. The proof ID is stored with the study so the work is verifiably yours.

Optional NEUS is completely optional. You can use Resonate with email/password or other sign-in methods only. Proof creation runs automatically in the background when NEUS is linked and does not change how you experience studies.
PLATFORM

Privacy & Security

Your spiritual journey is deeply personal. Resonate treats it that way.

🔒

AES-256 Encryption

All API keys and sensitive data are encrypted at rest using AES-256-CBC with a unique initialization vector per record.

🚫

Zero Advertisements

Resonate will never display ads. Your attention belongs to God, not advertisers. This is a core principle, not a business decision.

🕵

No Data Sales

Your prayers, your studies, your journal entries — none of it is sold, shared, or used for advertising. Your data is yours.

🔐

Bcrypt Password Hashing

All passwords are hashed with bcrypt before storage. We never have access to your actual password.

💳

Secure Payments via Stripe

All payment processing is handled by Stripe. Card details never touch our servers. Subscriptions are verified against Stripe on every login.

PLATFORM

Technology

Under the hood, Resonate is built on a purpose-driven stack chosen for speed, reliability, and the ability to deliver seminary-quality content in real time.

ComponentTechnologyPurpose
AI EngineGoogle Gemini 3 FlashGenerates theologically-grounded studies, prayers, and chat responses in milliseconds.
Image GenGemini Nano BananaAI-generated badge artwork and visual assets.
BackendPHP 8+Server-side logic, session management, API routing, and Stripe integration.
DatabaseSQLiteLightweight, zero-config database. No external server required.
FrontendTailwind CSS + GSAPUtility-first styling with cinematic scroll-driven animations.
PaymentsStripe APISecure subscription billing with custom "pay what you want" pricing.
TypographyCinzel + Playfair DisplayClassical serif pairing evoking ancient manuscripts and sacred texts.
Theme systemdata-theme + CSS variablesLight/dark mode and optional accent color; persisted in user settings and applied site-wide.
NEUSapi.neus.networkWeb3 identity linking and cryptographic proof creation for studies.
PLATFORM

Updates & Changelog

New features, improvements, and bug fixes are documented on a dedicated changelog page. Check it to see what's new and what's coming next.

Page: updates.php

PLATFORM

Feedback & Support

Found a bug? Have an idea for a new feature? Want to share how Resonate has impacted your walk with God? We want to hear from you. A built-in feedback system is available on every page of the platform via the footer.

SUBMIT Feedback Form
FieldTypeDescription
namestringYour name (auto-filled if logged in).
emailstringYour email for follow-up (auto-filled if logged in).
categoryselectBug Report, Feature Request, General Feedback, or Testimonial.
messagetextYour detailed feedback or request.
We Read Everything Every piece of feedback is reviewed by our team. Bug reports are triaged immediately, feature requests are added to our roadmap, and testimonials genuinely make our day. Scroll down to the footer on any page to find the feedback button.
SUPPORT

Support the Mission

Resonate is built and maintained by a small team driven by faith, not venture capital. Every donation goes directly toward keeping the platform free, improving the AI engine, and reaching more believers worldwide.

Where Donations Go

AI Processing

Server Costs

🔒

Security

🔨

Development

Ready?

Begin Your Journey

No ads. No data selling. No paywall on the Word of God.
Just you, the Scripture, and a guide to help you understand it.

Create Your First Study — Free