guuly05/gabay-keeper

Gabay Keeper is a web-based digital archive for preserving, organizing, and revisiting Somali oral poetry. The project focuses on Gabay and related poetic forms, giving users a private workspace where they can record poem text, authorship metadata, genre, xaraf, tags, source links, footnotes, and shareable visual archive cards. # Gabay Keeper Gabay Keeper is a web-based digital archive for preserving, organizing, and revisiting Somali oral poetry. The project focuses on Gabay and related poetic forms, giving users a private workspace where they can record poem text, authorship metadata, genre, xaraf, tags, source links, footnotes, and shareable visual archive cards. The application was created as a cultural preservation tool. Somali poetry has historically lived through oral transmission, handwritten notes, recordings, community memory, and scattered online sources. Gabay Keeper brings those fragments into one structured archive so poems can be cataloged with context rather than stored as loose text. ## Table of Contents - Purpose - Core Features - Methodology - Technology Stack - Architecture - Security Model - Local Setup - Firebase Setup - Running the App - Deployment - Project Structure - Quality Checks - Roadmap - License ## Purpose The goal of Gabay Keeper is to provide a respectful and practical digital home for Somali poetic heritage. Somali poetry is not only literary expression. It can preserve genealogy, social critique, humor, law, memory, conflict, praise, grief, and political history. Many poems are shared orally or stored informally, which makes them vulnerable to being lost, misattributed, or separated from their cultural setting. Gabay Keeper was built to help with that problem by offering: - A structured archive for original Somali poem text. - Metadata fields for poet, genre, xaraf, source, and tags. - Personal ownership so each user controls their own archive. - Footnotes for interpretation, explanation, and research notes. - OCR support for extracting text from scanned documents and images. - Search and filtering tools for browsing a growing collection. - Visual card export for sharing preserved poems outside the app. ## Core Features ### Authentication Users can create an account and sign in with Firebase Authentication using email and password. ### Poem …