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