Words of Fire - Product Requirements Document

Version: 1.0
Date: December 11, 2025
Author: Gary Sheng
Document Type: Stack-Agnostic PRD

---

Executive Summary

Words of Fire is a mobile application designed for Christians who practice Word of Faith declarations. The app provides a simple, focused experience for speaking daily faith declarations each morning, tracking consistency through a streak system, and building a daily spiritual discipline.

The core insight: Most people don't need complex features. They need a simple, beautiful way to speak God's promises over their lives every morning and see their consistency over time.

---

Stack Recommendation

The implementing LLM should choose the optimal tech stack based on these priorities:

1. Cross-platform mobile deployment (iOS and Android)
2. Simple payment/subscription integration (consider platforms that simplify Stripe/payment complexity)
3. Local-first data storage with optional cloud sync
4. Push notification support for scheduled reminders
5. Audio playback capabilities for auto-play mode
6. Minimal backend requirements (most logic is client-side)

Suggested approaches to evaluate:

• React Native / Expo
• Flutter
• Native iOS (Swift) + Native Android (Kotlin)
• No-code/low-code mobile builders (e.g., FlutterFlow, Buildship, Thunkable)

---

Core Value Proposition

For Christians who believe in speaking God's promises over their lives, Words of Fire provides a daily ritual that takes approximately 5 minutes each morning. Unlike generic affirmation apps, Words of Fire is specifically designed for Word of Faith practitioners with scripture-based declarations.

---

User Stories

Primary User Flow

1. As a user, I want to set my preferred morning declaration time so I receive a reminder when it's time for my daily declarations.

2. As a user, I want to go through my daily declarations one at a time, speaking each one aloud, so I can activate God's promises over my life.

3. As a user, I want to see my streak count after completing my declarations so I know how consistent I've been.

4. As a user, I want to use auto-play mode so declarations advance automatically while I speak them.

5. As a user, I want to customize which declarations appear in my daily flow so I can focus on specific promises.

6. As a user, I want to add my own custom declarations so I can include personal faith confessions.

---

Feature Specifications

1. Daily Declarations Flow

Description: The core experience where users speak faith declarations aloud.

Requirements:

• Display one declaration at a time, full-screen, with large readable text
• Include scripture reference beneath each declaration when applicable
• Show progress indicator (e.g., "3 of 15")
• "Next" button to manually advance to the next declaration
• "Previous" button to go back if needed
• User MUST complete the entire flow to receive streak credit (no partial credit)

Declaration Display Format:

[Declaration Text]
- [Scripture Reference] (if applicable)

Example:
"By His stripes, I was healed."
- Isaiah 53:5

End of Flow:

• Display "Hallelujah!" celebration screen
• Show streak increment animation (e.g., "🔥 Day 7!")
• Display encouraging message
• Option to share streak (optional future feature)

---

2. Auto-Play Mode

Description: Hands-free mode where declarations automatically advance.

Requirements:

• Toggle to enable/disable auto-play at start of flow or during flow

• Duration is calculated per declaration based on word count

• Minimum two speed settings (measured in milliseconds per word):

  Speed	Name	Ms per Word	Example: 10-word declaration	Example: 50-word declaration	Use Case
  1	Slow/Meditative	~400ms	4 seconds	20 seconds	New users, thoughtful pace
  2	Standard	~250ms	2.5 seconds	12.5 seconds	Regular daily use
  3	Fast (optional)	~150ms	1.5 seconds	7.5 seconds	Experienced users

  Note: Add a minimum floor (e.g., 3 seconds) so very short declarations like "I am strong." don't flash by too quickly.

• Visual countdown/progress indicator showing time remaining before next declaration

• Audio cue (gentle chime) when transitioning to next declaration (can be toggled off)

• Pause button to stop auto-advance temporarily

• Auto-play remembers user's last selected speed

---

3. Streak System

Description: Track consecutive days of completing declarations.

Requirements:

• Streak counter displayed prominently on home screen
• Streak increments ONLY when full declaration flow is completed
• Streak resets to 0 if user misses a day
• "Day" is defined by user's local timezone (midnight to midnight)
• Grace period: None (keep it simple and honest)
• Streak history/calendar view showing completed days (optional v2 feature)

Streak Display:

• Current streak count with fire emoji (🔥)
• Best streak record (optional)
• Simple encouragement messages based on streak milestones:
  • Day 1: "Great start!"
  • Day 7: "One week strong!"
  • Day 30: "A month of faith!"
  • Day 100: "Century of declarations!"

---

4. Declaration Management

Description: Users can customize their declaration list.

Requirements:

• Default set of 45 pre-loaded Word of Faith declarations (see Appendix A)
• Each declaration has:
  • Text content
  • Scripture reference (if applicable)
  • Active/inactive toggle
  • Category tag (optional: healing, provision, identity, protection, etc.)
• Toggle individual declarations on/off
• Minimum 1 declaration must be active to start daily flow
• "Select All" / "Deselect All" options
• Filter by category (optional v2)

Custom Declarations:

• Users can add their own declarations
• Fields: Declaration text, optional scripture reference, optional category
• Custom declarations appear in their own section
• Can be edited or deleted
• Can be toggled on/off like default declarations

---

5. Scheduled Notifications

Description: Daily reminder to complete declarations.

Requirements:

• Time picker for setting daily notification time
• Default: 7:00 AM local time
• Single daily notification
• Notification text options (rotate or pick):
  • "Time to speak life over your day 🔥"
  • "Your daily declarations are waiting"
  • "Start your day with God's promises"
• Notification taps directly into declaration flow
• Option to disable notifications entirely

---

6. Settings

Description: App configuration options.

Requirements:

• Notification time: Time picker
• Notifications enabled: Toggle
• Auto-play default speed: Selector
• Auto-play transition sound: Toggle
• Dark mode: Toggle (or follow system)
• Manage subscription: Link to subscription management
• About/Help: App information, contact, FAQ
• Privacy Policy / Terms: Required legal links

---

User Interface Guidelines

Design Principles

1. Simplicity First: Every screen should have one clear purpose
2. Readability: Declaration text must be large, clear, and easy to read aloud
3. Warmth: Use warm colors (golds, oranges, deep reds) suggesting fire and the Holy Spirit
4. Focus: Minimize distractions during declaration flow
5. Encouragement: Celebrate consistency without being annoying

Color Palette

The brand combines fire (passion, Holy Spirit) with royalty (Kingdom of God) and purity (holiness).

Role	Color	Hex Example	Usage
Primary	Fiery Orange	#FF6B00	Primary buttons, streak flames, key actions
Secondary	Royal Blue	#1E3A8A	Headers, navigation, trust elements
Accent - Fire	Deep Red/Crimson	#DC2626	Highlights, urgency, fire gradients
Accent - Gold	Holy Gold	#F59E0B	Celebrations, streaks, achievements
Background - Dark	Deep Black	#0A0A0A	Dark mode primary background
Background - Light	Pure White	#FFFFFF	Light mode, cards, content areas
Surface	Soft White/Off-white	#FAFAFA	Light mode backgrounds, subtle contrast
Text - Primary	White or Black	#FFFFFF / #111111	High contrast based on background

Gradient Suggestions:

• Fire gradient: Orange (#FF6B00) → Deep Red (#DC2626) → Gold (#F59E0B)
• Royal fire: Royal Blue (#1E3A8A) → Purple (#7C3AED) → Fiery Orange (#FF6B00)

Dark Mode (default recommended):

• Background: Deep black with subtle blue undertone
• Fire colors pop dramatically against dark backgrounds
• White text for declarations

Light Mode:

• Clean white backgrounds
• Royal blue for structure
• Fire colors for CTAs and celebrations

Typography

• Declaration text: Large, bold serif or clean sans-serif (28-36pt)
• Scripture reference: Smaller, italicized
• UI elements: Clean sans-serif

---

Data Model

User

User {
  id: string
  email: string (optional, for sync)
  notification_time: time
  notifications_enabled: boolean
  autoplay_speed: enum (slow, standard, fast)
  autoplay_sound_enabled: boolean
  theme: enum (dark, light, system)
  subscription_status: enum (trial, active, expired, none)
  trial_end_date: date
  created_at: timestamp
}

Declaration

Declaration {
  id: string
  text: string
  scripture_reference: string (optional)
  category: string (optional)
  is_default: boolean
  is_active: boolean
  display_order: number
  created_at: timestamp
}

DailyCompletion

DailyCompletion {
  id: string
  user_id: string
  completed_date: date
  declarations_count: number
  completed_at: timestamp
}

Streak (computed or cached)

Streak {
  current_streak: number
  best_streak: number
  last_completion_date: date
}

---

Business Model

Pricing Strategy

Based on market research of affirmation apps:

• Free Trial: 3 days full access
• Annual Subscription: $69.99/year (~$5.83/month)
• Monthly Subscription (optional): $9.99/month

Paywall Placement

• Show paywall after trial expires
• During trial: Full access to all features
• After trial expires without subscription:
  • Can view streak (but it's frozen)
  • Cannot complete daily declarations
  • Clear CTA to subscribe

Free Tier (Alternative Model - Optional)

If choosing a freemium model instead:

• Free: Limited to 5 default declarations, no custom declarations
• Paid: Full declaration library, custom declarations, advanced stats

---

The 45 Everyday Faith Declarations (Appendix A)

The app ships with these 45 Word of Faith declarations. Each should be toggleable.

Daily Foundation (1-10)

1. "This is the day the Lord has made and I will rejoice and be glad in it."

   • Psalms 118:24

2. "I am in the right place at the right time doing the right thing and I am blessed, blessed, blessed."

   • Psalms 37:23-24

3. "I am a thought life champion. What a man speaks out of his mouth shall be. What a man speaks in his heart, he is."

   • Proverbs 23:7

4. "Father, I am your sheep, I hear Your voice every day and I follow You."

   • John 10:27

5. "Thank You, Lord, You forgive me. Lord, You heal me. You redeem my life from destruction today. You crown my life with loving-kindness and tender mercies. Today, today, You satisfy my mouth with good things so that my youth is renewed like the eagles."

   • Psalms 103:3-5

6. "You are my Father, my Refuge, and my Fortress. My God, I trust You. Thank You for delivering me today."

   • Psalms 91:2-3

7. "I am delivered from the powers of darkness."

   • Colossians 1:13

8. "Lord, I put on my armor of light."

   • Romans 13:12

9. "I declare I have power to tread on serpents and scorpions and over all the powers of the enemy and nothing, by any means shall hurt me."

   • Luke 10:19

10. "I declare no evil shall touch me, nor any plague come near my dwelling place."

    • Psalms 91:10, Ecclesiastes 8:5

Healing & Strength (11-20)

11. "I declare I am healed by His stripes today."

    • Isaiah 53:5

12. "I am strong."

    • Joel 3:10

13. "Bless me indeed, enlarge my coast. Be with me, keep me from evil; from grief."

    • 1 Chronicles 4:10

14. "I declare I am prosperous and live in health. Never sick."

    • 3 John 1:2

15. "Because I am blessed of my Lord, I am rich."

    • Proverbs 10:22

16. "I am both a symbol and a source of the blessing."

    • Zechariah 8:13

17. "I am a good harvester, I have faith to reap Your harvest every day. I will not forget that I bring in my harvest by faith. I call it in."

    • John 4:35-38

18. "Multiplied, my children's days and my days as days of Heaven on Earth."

    • Deuteronomy 11:21

19. "I hide Your words in my heart that I might not sin. I delight myself in Your Word."

    • Psalms 119:11-16

20. "It is my time for favor. For You to favor me."

    • Psalms 102:13

Surrender & Kingdom (21-30)

21. "I pray oh Lord, write Your words, Your laws upon my heart and engrave them in my mind in the mighty name of Jesus Christ of Nazareth."

    • Hebrews 8:10

22. "I yield myself to God as one that is alive from the dead, and my members as instruments of righteousness to God."

    • Romans 6:13

23. "I release the Kingdom of God to work on my behalf today in the name of Jesus."

    • Matthew 6:33, Luke 17:21

24. "Thank You Father, I ask, declare and receive Great Grace."

    • 2 Corinthians 9:8

25. "I am a master of God's Words. I hear what He says and I say it, I see what He does and I do it."

    • Ephesians 4:24

26. "Only with my eyes shall I see and behold the reward of the wicked."

    • Psalms 91:8-9

27. "God covers me with His feathers, and under His wings I trust. His truth is my shield and buckler."

    • Psalms 91:4

28. "God gives His angels charge over me, to keep me in all my ways. They bear me up in their hands."

    • Psalms 91:11-12

29. "I take my Word medicine today. God restores health unto me and heals me of my wounds."

    • Jeremiah 30:17

30. "The Lord is my healer. He takes sickness away from the midst of me."

    • Exodus 15:26, Exodus 23:25-26

Blessing & Anointing (31-40)

31. "The Lord blesses me and makes me a thousand times more as I am, and blesses me as He has promised."

    • Deuteronomy 1:11

32. "The anointing which I have received abides in me and teaches me all things."

    • 1 John 2:27

33. "Because I have left all for Jesus' sake and the gospel, I shall receive a hundredfold now in this time and eternal life."

    • Mark 10:29-30

34. "I rejoice with joy unspeakable and full of glory. I shall go out with joy and be led forth with peace."

    • 1 Peter 1:8, Isaiah 55:12

35. "With great power and great grace, signs and wonders are wrought by my hands."

    • Acts 4:33, Acts 5:12

36. "Father, I ask for wisdom and an understanding heart to do all You've called me to do for Your people."

    • 1 Kings 3:9-13

37. "I trust that God will not break His covenant, nor alter the thing that has gone out of His lips. Every word of God is pure."

    • Psalms 89:34, Malachi 3:6, Proverbs 30:5

38. "I have an unction from the Holy One, and I know all things."

    • 1 John 2:20

39. "I pray for the peace of Jerusalem. I prosper because I love her."

    • Psalms 122:6-7

40. "I commit my works to the Lord, and my thoughts are established."

    • Proverbs 16:3

Life & Righteousness (41-45)

41. "God's words are life to me, and health to all my flesh."

    • Proverbs 4:20-22

42. "By the word of God's lips I am kept from the paths of the destroyer."

    • Psalms 17:4

43. "I walk in the way of righteousness where there is life; in this pathway there is no death."

    • Proverbs 12:28

44. "God will fulfill my desires as I fear Him. He hears my cry and saves me."

    • Psalms 145:19-20

45. "I delight myself in the Lord, and He shall give me the desires of my heart."

    • Psalms 37:4

---

Technical Requirements

Performance

• Declaration flow must be smooth (60fps animations)
• App launch to declaration flow: < 2 seconds
• Offline-first: Core functionality works without internet

Reliability

• Streak data must persist reliably (critical user data)
• Notifications must fire reliably at scheduled time
• Handle timezone changes gracefully

Privacy

• Minimal data collection
• Streak and declaration data stored locally by default
• Optional account creation for cloud backup
• No selling of user data
• Clear privacy policy

Platform Requirements

• iOS 14+
• Android 8+
• Support for tablets (responsive layout)

---

Success Metrics

Primary Metrics

• Daily Active Users (DAU): Users completing daily declarations
• 7-Day Retention: % of users returning after 1 week
• Average Streak Length: Measures habit formation
• Trial-to-Paid Conversion Rate: Target 5-10%

Secondary Metrics

• Notification enable rate
• Auto-play usage rate
• Custom declarations created per user
• Average declarations per session

---

MVP Scope (v1.0)

Must Have:

• Daily declaration flow with manual next/previous
• Auto-play mode with 2 speeds
• Streak tracking (current streak display)
• "Hallelujah" completion celebration
• 45 default declarations (the full "Everyday Faith Declarations" set)
• Toggle declarations on/off
• Add custom declarations
• Scheduled notification with time picker
• Basic settings (notification time, theme)
• Subscription paywall with 3-day trial

Nice to Have (v1.1+):

• Streak calendar view
• Categories/filtering
• Share streak functionality
• Best streak tracking
• Cloud sync/backup
• Widget for home screen
• Apple Watch complication

---

Open Questions for Implementation

1. Should the auto-play include optional background music/ambient audio?
2. Should there be audio recordings of declarations that users can listen to (vs. just reading)?
3. Is there value in a "read along" mode where words highlight as spoken?
4. Should users be able to reorder declarations?
5. Should completed declarations show a checkmark during the flow?

---

Appendix B: Competitive Landscape

Similar apps in the affirmation/faith declaration space:

• I Am - Generic affirmations app
• ThinkUp - Record your own affirmations
• Motivation - Daily quotes and affirmations
• Glorify - Christian app with broader scope

Differentiation: Words of Fire is specifically designed for Word of Faith practitioners, focusing purely on speaking scripture-based declarations with streak tracking. No journaling, no meditation, no music. Just declarations and consistency.

---

Implementation Notes

For the implementing LLM:

1. Prioritize the core loop: Getting declarations → Speaking them → Completing streak → Celebration
2. Keep the UI minimal: One declaration per screen, large text, clear actions
3. Make streak persistence bulletproof: This is the most important user data
4. Test notification reliability: This drives daily engagement
5. Subscription flow should be frictionless: Use platform-native payment (Apple/Google)

The app should feel like a daily spiritual discipline tool, not a complex productivity app. Simplicity is the feature.

---

"Death and life are in the power of the tongue." - Proverbs 18:21