
Building coptic.io
I built something that sounds niche, because it is. coptic.io is a lightweight TypeScript API that serves up the Coptic calendar, complete with daily readings from the Katameros. Think of it as a small bridge between a 1700-year-old tradition and today’s developer workflows.
What Is It?
At its core, coptic.io
lets you:
- Fetch detailed readings for any Coptic day
- Retrieve reference readings tied to that date
- Convert Gregorian dates into Coptic dates
All through a simple, modern API.
Why Build This?
- Cultural depth, accessible via code: the Coptic calendar isn’t mainstream, but it’s central to a living tradition. Exposing it through an API makes it more usable.
- Clean technical foundation: built in TypeScript, with Express + GraphQL, Swagger docs, Jest/Mocha tests, Winston logging, and PM2 support for production.
- Open source, MIT-licensed: the project lives on GitHub and is open for contributions.
Technical Highlights
- Express + GraphQL backbone
- Swagger UI for exploring endpoints
- TypeScript for clarity and safety
- Testing with Jest & Mocha
- Production-ready with PM2
Roadmap
There’s more I’d like to add:
- Bulk exports (iCal, JSON-L)
- Holiday & fasting period detection
- Timezone/locale edge cases
Issues and feature requests are open on GitHub if you want to chime in.
Try It Yourself
git clone https://github.com/abanobmikaeel/coptic.io.git
cd coptic.io
yarn install
yarn dev