gyebi/dawuro-ghananews
Record type:
software
Creator:
gye
Host:
Dawuro is a Ghana-focused, user-driven news app that helps people quickly find and read news from trusted Ghanaian sources.
# Dawuro Ghana News
Dawuro is a Ghana-focused, user-driven news app that helps people quickly find and read news from trusted Ghanaian sources.
The idea comes from the traditional dawuro, also known as the gong-gong, which was used in communities to announce important messages. In the same way, the app acts as a modern digital dawuro: it brings important Ghanaian news and updates directly to users.
## App Summary
Dawuro lets users browse, search, and filter Ghanaian news based on what they care about. The app loads default latest news, but users can also search for specific topics like:
- Education
- Politics
- Business
- Black Stars
- Cedi
- Health
- Entertainment
It pulls stories from Ghanaian news websites using a FastAPI backend, source-specific APIs/RSS feeds, and BeautifulSoup fallback scraping.
## Current Features
The MVP currently has:
- React Native frontend
- FastAPI backend
- Firebase scheduled sync function
- Source-specific news retrieval with BeautifulSoup fallback scraping
- Ghanaian news sources: Citi Newsroom, MyJoyOnline, and Graphic Online
- Search functionality
- Source/news agency filtering
- Story details screen
- Logo and branding
## Backend Records
Stories are saved in the Firestore `stories` collection. Dawuro uses the story URL, or the title when no URL exists, to create a stable SHA-256 document ID so repeat syncs update the same record instead of creating duplicates.
Saved story fields:
- `title`
- `summary`
- `source`
- `category`
- `url`
- `createdAt`
- `updatedAt`
- `publishedAt`
The `createdAt` field is only set when a story is first saved. The `updatedAt` field refreshes every time Dawuro sees the story again. The `publishedAt` field is preserved when the source provides a publication date.
Sync runs are recorded in the Firestore `syncLogs` collection with:
- `message`
- `count`
- `ranAt`
## Demo Routine
Start the local FastAPI backend from `backend-mobile`:
```bash
uv run uvicorn main:app --host 0.0.0.0 --port 800 …