Challenges

Document Version: 1.0
Last Updated: January 2025
Applies To: Church Leaders, Administrators, SuperAdmins

---

Table of Contents

1. Overview
2. Challenge Structure
3. Creating Challenges
4. Managing Challenges
5. Scheduling & Recurrence
6. Student Experience
7. XP & Rewards
8. Analytics & Tracking
9. Troubleshooting
10. Best Practices

---

1. Overview

Purpose

Challenges are action-oriented tasks designed to encourage students to practice their faith outside of regular church activities. They provide structure, motivation, and accountability for spiritual growth.

Key Features

• Five Categories: Prayer, Reading, Service, Worship, Community
• Three Durations: Daily, Weekly, One-Time
• XP Rewards: Gamified motivation system
• Scheduling: Immediate or future publish dates
• Recurrence: Automatic repeating challenges
• Participant Tracking: Monitor completion rates

Access Levels

Role	Can Create	Can Edit	Can View All
SuperAdmin	✅ (all churches)	✅	✅
Admin	✅ (own church)	✅ (own church)	Own church only
ChurchLeader	❌	❌	Own church only
Student	❌	❌	Own church only

---

2. Challenge Structure

Required Fields

Field	Type	Constraints	Description
Title	String	Max 50 chars	Clear, action-oriented name
Description	String	Max 200 chars	Specific instructions for completion
Category	Enum	Required	Prayer, Reading, Service, Worship, Community
Duration	Enum	Required	Daily, Weekly, One-Time
XP Reward	Number	Min: 0	Points awarded on completion

Optional Fields

Field	Type	Default	Description
Publish Date	DateTime	Immediate	When challenge becomes visible
Recurrence	Enum	None	None, Daily, Weekly, Monthly

Challenge Statuses

Status	Description	Visibility
Live	Currently active and visible to students	✅ Visible
Scheduled	Set to publish at future date	❌ Hidden
Completed	Archived, no longer active	❌ Hidden

Status Transitions

[Created] → [Scheduled] → [Live] → [Completed]
              ↓
         (If no publishAt)
              ↓
           [Live]

---

3. Creating Challenges

Accessing the Challenge Creator

1. Navigate to Admin Dashboard
2. Click Challenges tab
3. Click “Create Challenge” button (or floating action button on mobile)

Step 1: Define the Challenge

Title Guidelines

• Use action verbs: “Read,” “Pray,” “Share,” “Write”
• Be specific: “Morning Prayer” not just “Prayer”
• Keep it short: Max 50 characters

Good Examples:

• ✅ “5-Minute Morning Prayer”
• ✅ “Read Psalm 23”
• ✅ “Text an Encouragement”
• ✅ “Write 3 Gratitudes”

Poor Examples:

• ❌ “Prayer Challenge” (too vague)
• ❌ “Do something nice for someone today because Jesus loves you” (too long)
• ❌ “Study” (not actionable)

Description Guidelines

• Explain exactly what to do
• Include any relevant details
• Max 200 characters

Good Examples:

• ✅ “Before you check your phone in the morning, spend 5 minutes talking to God about your day ahead.”
• ✅ “Send a text to someone you haven’t talked to in a while. Let them know you’re thinking of them.”

Category Selection

Category	Icon	Use For
Prayer	🙏	Any form of communication with God
Reading	📖	Scripture reading, devotionals, journaling
Service	🤝	Helping others, volunteering, kindness
Worship	🎵	Music, praise, gratitude expressions
Community	👥	Relationship building, group activities

Duration Selection

Duration	Best For	Student Expectation
Daily	Habit-building tasks	Complete within 24 hours
Weekly	Larger commitments	Complete within 7 days
One-Time	Special events/seasons	Complete when ready

XP Reward Guidelines

Difficulty	XP Range	Examples
Easy	10-25	Read a verse, pray briefly
Moderate	25-50	Journal entry, share with friend
Challenging	50-100	Service project, spiritual conversation
Major	100+	Lead devotions, complete multi-day series

Step 2: Schedule the Challenge

Publish Date Options

Immediate (Default)

• Challenge goes live as soon as you submit
• Status: “Live”
• Visible to students immediately

Scheduled

• Select a future date
• Status: “Scheduled”
• Automatically transitions to “Live” on publish date

Recurrence Options

Option	Behavior
None	Challenge is one-time only
Daily	Creates new challenge every day at same time
Weekly	Creates new challenge every week on same day
Monthly	Creates new challenge every month on same date

Note: Recurring challenges automatically inherit all settings from the original.

Submitting the Challenge

1. Review all fields
2. Click “Create Challenge”
3. Challenge appears in appropriate status tab
4. Confirmation toast displays

---

4. Managing Challenges

Viewing Challenges

Filter by Status

Use tabs to filter:

• Live: Currently active challenges
• Scheduled: Future challenges
• Completed: Archived challenges

Search

• Type in search bar
• Searches title and description
• Real-time filtering

Challenge List Views

Mobile View: Card-based layout

• Title with category icon
• Description preview
• Status badge
• Duration badge
• Participant count
• XP reward

Desktop View: Table layout

• Title
• Category
• Publish Date
• XP Reward
• Status

Editing Challenges

1. Find challenge in list
2. Click on the challenge (or edit button)
3. Modal opens with current values
4. Modify desired fields
5. Click “Update Challenge”

What Can Be Edited:

• Title
• Description
• Category
• Duration
• XP Reward
• Publish Date
• Recurrence

What Cannot Be Changed:

• Church ID
• Creator ID
• Created Date
• Participant history

Archiving Challenges

To move a live challenge to completed:

1. Edit the challenge
2. Change status to “Completed”
3. Save changes

Archived challenges:

• No longer visible to students
• Preserved in database
• Viewable in “Completed” tab

Deleting Challenges

⚠️ Warning: Deletion is permanent

1. Access challenge
2. Click delete option
3. Confirm deletion
4. Challenge is permanently removed

Recommendation: Archive instead of delete to preserve historical data.

---

5. Scheduling & Recurrence

Scheduling for Future Dates

Use Cases

• Seasonal content (Christmas, Easter)
• Back-to-school series
• Coordinated with sermon series
• Event-related challenges

How Scheduling Works

1. Set publish date when creating/editing
2. Challenge status: “Scheduled”
3. System checks daily for scheduled challenges
4. When publish date arrives, status changes to “Live”
5. Students can now see and complete the challenge

Setting Up Recurrence

Daily Recurrence

• New challenge created each day
• Same title, description, category, XP
• Ideal for habit-building (prayer, reading)

Weekly Recurrence

• New challenge created each week
• Same day of week as original
• Good for regular rhythm challenges

Monthly Recurrence

• New challenge created each month
• Same date as original
• For less frequent, larger tasks

Upcoming Challenges Calendar

The Admin Dashboard displays a 14-day calendar view showing:

• Today’s challenges (highlighted)
• Upcoming scheduled challenges
• Challenge density per day

Use this to:

• Avoid scheduling conflicts
• Ensure consistent challenge flow
• Plan around events

---

6. Student Experience

How Students Access Challenges

Students see challenges in multiple places:

• Home Feed: Current challenges displayed
• Study Tab: Challenge section
• Notifications: New challenge alerts

Completing a Challenge

1. Student views challenge details
2. Performs the required action
3. Marks challenge as complete in app
4. XP is awarded
5. Completion is logged

What Students See

For each challenge:

• Title and description
• Category icon
• XP reward value
• Completion button
• Their completion status

Challenge History

Students can view:

• Challenges they’ve completed
• XP earned per challenge
• Total challenges completed
• Category breakdown

---

7. XP & Rewards

How XP Works

When a student completes a challenge:

1. Challenge is marked complete
2. XP is added to their profile
3. Total XP updates
4. Level progress updates
5. Leaderboard position recalculates

XP Best Practices

Consistency

• Similar challenges should award similar XP
• Create a mental framework for your church

Scaling

• Higher difficulty = more XP
• Longer duration can mean more XP
• Multi-step challenges deserve bonus XP

Sample XP Framework

Task Type	Base XP
Read 1 verse	10
Read 1 chapter	15
5-min prayer	15
Journal entry	20
Share with friend	25
Service act	30
Spiritual conversation	50
Lead devotion	75
Complete series	100+

Achievement Triggers

Completing challenges can unlock achievements:

• First challenge completed
• 10/25/50/100 challenges completed
• Category-specific milestones
• Streak-based achievements

---

8. Analytics & Tracking

Metrics Available

Per Challenge

• Participant Count: Students who completed
• Completion Rate: % of active users who completed
• Time to Complete: Average time from publish to completion

Aggregate

• Total Challenges Created: All-time count
• Active Challenges: Currently live
• Total XP Awarded: Sum of all challenge XP
• Most Popular Category: Highest participation

Using Analytics

Identify Winners

• Which challenges get highest completion rates?
• What XP levels drive engagement?
• Which categories resonate most?

Spot Problems

• Low participation on certain challenges
• Declining engagement over time
• Category imbalances

Make Adjustments

• Double down on popular types
• Retire underperforming formats
• Adjust XP rewards based on data

Export Options

Challenge data can be exported for:

• Board reports
• Ministry planning
• Parent communication
• Year-end reviews

---

9. Troubleshooting

Common Issues

Challenge Not Appearing for Students

Possible Causes:

1. Status is “Scheduled” not “Live”
2. Publish date hasn’t arrived
3. Challenge created for wrong church

Solutions:

1. Check status tab—confirm it’s in “Live”
2. Verify publish date is in the past
3. Confirm churchId matches student’s church

Can’t Create Challenge

Possible Causes:

1. Not logged in as admin
2. No church assigned to user
3. Form validation errors

Solutions:

1. Verify admin or SuperAdmin role
2. Check userData.churchId exists
3. Fill all required fields (title, description, category, duration)

Participant Count Not Updating

Possible Causes:

1. Database sync delay
2. Student completion not saved
3. Network error on completion

Solutions:

1. Refresh the page
2. Check student’s challenge history
3. Verify network connectivity

Scheduled Challenge Didn’t Go Live

Possible Causes:

1. Server-side job not running
2. Timestamp format issue
3. Timezone mismatch

Solutions:

1. Manually edit status to “Live”
2. Check publish date format
3. Contact support if recurring

Error Messages

Error	Meaning	Fix
“churchId required”	No church assigned	Assign user to church
“auth required”	Not authenticated	Log in again
“Failed to load challenges”	Database error	Refresh, check network
“Missing church information”	Church lookup failed	Contact support

---

10. Best Practices

For Creating Effective Challenges

Be Specific

• ❌ “Pray more”
• ✅ “Spend 5 focused minutes in prayer before breakfast”

Be Achievable

• Match difficulty to duration
• Daily = quick and easy
• Weekly = more involved

Be Relevant

• Connect to current teaching
• Acknowledge seasons and events
• Know your students’ lives

Be Varied

• Rotate categories
• Mix difficulty levels
• Balance solo and social tasks

For Managing Challenge Flow

Maintain Rhythm

• 1-2 active challenges at any time
• Consistent posting schedule
• Don’t overwhelm students

Plan Ahead

• Schedule 2-4 weeks in advance
• Align with church calendar
• Build series around themes

Review Regularly

• Weekly: Check participation
• Monthly: Analyze trends
• Quarterly: Adjust strategy

For Maximizing Engagement

Celebrate Completions

• Announce in group chat
• Recognize high achievers
• Create milestone celebrations

Follow Up

• Discuss challenges in small groups
• Ask students about experiences
• Share stories of impact

Create Community

• Group challenges
• Leaderboard competitions
• Team-based goals

---

Appendix A: Quick Reference

Challenge Creation Checklist

• [ ] Clear, action-oriented title (≤50 chars)
• [ ] Specific description (≤200 chars)
• [ ] Category selected
• [ ] Duration selected
• [ ] XP reward set appropriately
• [ ] Publish date set (if scheduled)
• [ ] Recurrence configured (if needed)

Category Icons

Category	Icon	Emoji
Prayer	🙏	:pray:
Reading	📖	:book:
Service	🤝	:handshake:
Worship	🎵	:musical_note:
Community	👥	:busts_in_silhouette:

Status Colors

Status	Color	Badge Class
Live	Green	bg-green-100
Scheduled	Blue	bg-blue-100
Completed	Gray	bg-gray-100

---

Appendix B: Sample Challenge Templates

Daily Prayer Challenge

Title: Morning Prayer Check-In
Description: Before looking at your phone, spend 3 minutes thanking God for a new day.
Category: Prayer
Duration: Daily
XP: 15
Recurrence: Daily

Weekly Reading Challenge

Title: Psalm of the Week
Description: Read Psalm 23 three times this week. Journal one thing that stands out each time.
Category: Reading
Duration: Weekly
XP: 30
Recurrence: Weekly

One-Time Service Challenge

Title: Random Act of Kindness
Description: Do something kind for a stranger today—buy their coffee, hold a door, write a note.
Category: Service
Duration: One-Time
XP: 25
Recurrence: None

---

Appendix C: Support

For issues not covered in this SOP:

• In-App Help: Settings → Help & Support
• Email: support@ori.app
• Documentation: ORI Help Center

---

This SOP is a living document. Last reviewed: January 2025.