# Biblical Battle Plans

> A Bible reading tracker built like a role-playing game: reading plans, streaks, XP, guilds, and a journal. A web app that works offline, and a native iPhone app on the App Store, both on the same API.

Community platform, a case sheet from ShirePath Solutions.
Source: https://shirepathsolutions.com/work/biblical-battle-plans

## Why it exists

I read a physical Bible, and I wanted to keep a reading streak without moving my reading into an app. The role-playing game is just a fun way to track it. Nothing like it existed, so I built it.

## What went wrong, and what it taught us

It hit its limits around a hundred users: no test environment, and the rules of the game buried in database queries. We rebuilt it as version two, with the rules in one shared package that every part of the app calls, covered by tests, and with every error logged, flagged in Slack, and summarized by Claude on request.

That rebuild paid off twice. The native iPhone app calls the same server the web app does, with its Swift types generated from the web's TypeScript definitions, and the build fails if the two drift apart. It has nearly everything the web does: reading check-offs, side quests, the church calendar, guilds with chat, leaderboards, and invites, the journal, achievements, and the animated tier sprites. Readers sign in with Apple, Google, or email, and phones stay signed in with a key that is replaced each time it is used and cancelled when the password changes. Reminders go out on an hourly and a nightly schedule, by web push and by Apple push.

We sent version 1.0 to App Review on November 5, 2026. It was approved on the first submission and released on November 6, 35 days after the first build ran on a real phone. Before that we added what the store asks of an app where people write to each other: reporting and blocking in guilds and chat, account deletion inside the app, and a privacy label checked against the app's own privacy manifest. It is free, has no in-app purchases, and runs on iPhone.

## What it does

- Reading plans with daily progress, and daily disciplines
- Streaks with shields, XP, levels, and achievements
- Guilds with leaderboards, chat, and prayer requests
- Offline reading on the web that syncs when it is back online
- Reminders by web push and Apple push
- Reporting and blocking in guilds and chat, on the web and iPhone
- A native iPhone app on the App Store, on the same API

## Project facts

- Status: Live on the web and iPhone
- For: ShirePath
- Runs on: Vercel, Neon
- Built with: Next.js, TypeScript, Turborepo, Neon (PostgreSQL), Drizzle ORM, NextAuth.js, Serwist, SwiftUI, Claude, SendGrid, Vercel

## Who built it

- [Conner Contreras](https://shirepathsolutions.com/about#conner): Lead builder

## Links

- [On the web: biblicalbattleplans.com](https://www.biblicalbattleplans.com/)
- [On the App Store: Biblical Battle Plans](https://apps.apple.com/us/app/biblical-battle-plans/id6758302258)

## Build notes

- [One API, Two Apps: Building the Biblical Battle Plans iOS App](https://shirepathsolutions.com/blog/biblical-battle-plans-on-ios)
- [How We Took Biblical Battle Plans from TestFlight to the App Store](https://shirepathsolutions.com/blog/biblical-battle-plans-on-the-app-store)

To talk about a build like this: https://shirepathsolutions.com/contact?about=biblical-battle-plans
