Overview
Isokratis is an Android app for Byzantine church singers, ported from a PWA. While chanting, the singer needs a stable reference drone — the isokratima. The app renders an interactive note grid in Byzantine notation and synthesizes the drone in real time, with scales, pitch shifting and per-user settings.
The product is a freemium SaaS: a free tier with four scales and a premium tier (14-day trial with no card, a Reader for PDF chant books, cross-device sync, custom scales, envelope and EQ editors, custom samples). Everything — product, API, database and deployment — was designed and implemented by me.
What I built
The Byzantine music model is defined in units of moria, where an octave is 72 moria. The seven notes (Νη Πα Βου Γα Δι Κε Ζω) sit on a fixed tonic, and the note grid is generated by rotating the interval steps of the selected scale — a direct encoding of the theory in code.
The audio engine is a typed signal chain: AudioSource → ActiveVoice → DroneEngine → destination, where each voice is an oscillator (through a low-pass filter) or a buffer sample, routed through EQ and gain with ADSR envelopes. Pitch shifting works in coarse (±6 moria) and fine (±1 moria) steps.
The API is a custom typed framework: each route is declared in a paired client/server module with shared Zod schemas, so request and response types are enforced end-to-end from a single definition. Session auth uses bearer tokens, with passwords hashed by PBKDF2, and sessions are checked in D1. Cross-device sync is offline-first and last-writer-wins per record, with each device’s data in SQLite.
Technical highlights
- 72-moria music model with scale-interval rotation and fixed tonic (Κε = 220 Hz)
- Drone engine on react-native-audio-api with polyphonic voices, ADSR envelopes and ±36 moria real-time shifting
- Typed client/server API contracts with shared Zod schemas
- D1 schema for users, sessions, multi-provider logins and premium state
- i18n in seven languages; self-hosted over-the-air updates served by the Worker
- Tested with
bun test, including scale math and user CRUD integration tests
Outcome
The site is at isokratis.byzantineapps.com, and the Android app, with its premium flow, trials and cross-device sync, is in internal testing on Google Play.

