How Zoyra is built: Expo, Supabase and a small backend
One app codebase, a managed database, and two small services you can run on a laptop.
Zoyra is a hobby-sized stack with professional habits. Everything is in one repository, and most of it can run on one machine.
The app
The app is written in TypeScript with Expo and React Native, using Expo Router for navigation. A single codebase produces both the iPhone and the Android app. Colours, spacing and type come from shared design tokens, so a new accent colour or the AMOLED black theme reaches every screen.
Supabase for the basics
Sign-in, the database, realtime updates, file storage and server functions come from Supabase. Database changes are kept as migrations in the repository, and security rules decide who can read what.
A backend you can run at home
Music search and streaming run in one container that holds the Python gateway and the Java extractor. It can run on a spare laptop, with a Cloudflare tunnel giving it a permanent https address and no open ports on the router. A small Docker image builds both services. The same image runs on a cloud server later if the audience grows.
Checks that run on every change
- Type checking and linting for the app.
- Automated tests for the gateway and for the share site.
- A syntax check of every database migration.
- Crash reporting that stays off until a key is provided.
Look inside
The whole thing is on GitHub. Start with the README, then open src/app for the screens, services/ for the backend and web/ for the websites.