Fana Tewahedo

An open-source TypeScript application built to streamline access to Orthodox Tewahedo spiritual resources, educational content, and media. I designed and developed the architecture to support robust typing, seamless content delivery, and clean UI/UX components.

Role
Lead Full-Stack Developer & Architect
Timeline
Ongoing Development
Status
Experimental

Result Successfully built a highly scalable and type-safe platform using TypeScript that consolidates fragmented spiritual literature, text, and media into a central, responsive application.

Live demoSource code

Overview

Fana Tewahedo is an open-source web application dedicated to preserving and sharing Ethiopian Orthodox Tewahedo spiritual literature, educational frameworks, and media. Built using TypeScript, the platform aims to bridge the gap between traditional heritage and modern technology, ensuring fast loading times, clean layouts, and deep type safety across complex data structures.

The problem

Spiritual and liturgical content in the Ethiopian Orthodox Tewahedo Church is often deeply nested, multifaceted, and traditionally available only in physical books or fragmented, outdated web pages. The technical challenge was to structure this multi-layered textual data, support multilingual integration (such as Ge'ez, Amharic, and English characters), and ensure a seamless, performant user experience on both mobile and desktop screens.

The solution

I built a cross-platform responsive application utilizing modern TypeScript practices. By structuring custom type interfaces for the data models, I ensured that scriptures, audio, and educational resources could be retrieved efficiently without payload bloat. The solution includes a highly optimized client interface that parses and displays text with pixel-perfect typography.

Process

1. Data Architecture & Schema Design: Mapped out the relations between liturgical categories, daily readings, and multimedia assets.

2. Frontend Development: Developed modular and reusable components in a component-driven architecture using TypeScript.

3. Typography Optimization: Configured layout settings specifically optimized for Ethiopic fonts to ensure clean rendering.

4. Performance Tuning: Integrated client-side caching to reduce load delays when fetching heavy textual data.

What I learned

- Strict Typing Benefits: Enforcing rigid TypeScript interfaces early in production drastically reduced runtime bugs when mapping diverse Amharic text collections.

- Localization Nuances: Learned the intricacies of handling Ethiopic script indexing, searching, and web font optimization for diverse modern viewports.

Features

  • Fully TypeScript-powered content architecture for type safety.
  • Clean, distraction-free user interface optimized for long-form reading.
  • Seamless multilingual text rendering (Amharic, Ge'ez, English).
  • Global modular layout built for high performance and minimal initial bundle size.

Results

  • Successfully established a centralized, open-source codebase for Tewahedo resources.
  • Improved UI loading efficiency by preventing unoptimized script rendering.
  • Created a highly scalable baseline architecture ready for future API integrations (like Redis caching and Docker deployment).

My contribution

  • Set up repository workflows, formatting rules, and component structures.
  • Architected the state management and data-fetching layer using strict TypeScript.
  • Designed and built responsive UI components to display extensive textual archives.
  • Managed the open-source Git workflow, issue tracking, and documentation.