Overview & Problem Statement
Independent digital newsrooms in East Africa face unique operational constraints: reporters often work on fluctuating cellular connections, while readers consume news on lower-tier mobile handsets with metered data plans. The editorial team in Juba needed a publishing platform that was fast to load, resilient during network drops, secure against unauthorized publishing, and simple enough for journalists to author articles, upload media, and syndicate to WhatsApp with a single tap.
Key Implemented Features
- Public News Desks & Breaking Ticker: Structured categorization across National, Politics, Business, Sports, and Video Hub, with live breaking news alerts.
-
Role-Based Newsroom CMS (
/admin): Server-verified authentication powered byjoseJWT stored in encrypted HTTP-only cookies, with permission scopes for administrators, editors, and authors. - Live Responsive Preview & Auto-Save: The custom article editor continuously saves working drafts to local storage, providing side-by-side desktop and mobile simulation alongside an automated Google Search snippet and social OpenGraph preview.
- Dual Cloud & Offline Persistence: Built with Prisma ORM querying PostgreSQL in production, with an atomic fallback adapter writing to local JSON in disconnected development environments.
-
Automated Syndication & SEO: Dynamic generation of standard RSS 2.0 feeds (
/rss.xml), XML sitemaps, WhatsApp click-to-share deep links, and Google News compliantNewsArticleSchema.org JSON-LD structured data.
My Work & Engineering Contributions
As lead full-stack developer, I architected and implemented the entire platform:
- Full-Stack Architecture: Built the Next.js 14 App Router project with Server Components, Server Actions, and Prisma ORM data modeling.
- Editorial CMS: Designed the administrative dashboard, markdown editor, and dual-viewport live preview engine.
- Authentication & Security: Implemented cookie-based JWT sessions with HMAC SHA-256 signatures and role middleware guards.
- Mobile Optimization: Styled the journalistic UI in Tailwind CSS, achieving instantaneous load times and zero Cumulative Layout Shift (CLS).
Technical Implementation & Architecture
The platform utilizes modern React Server Components to render editorial desks directly on the edge, sending minimal JavaScript to client browsers:
- Edge Caching: Next.js route handlers cache public news feeds with on-demand revalidation whenever new articles are published in the CMS.
- Prisma PostgreSQL Schema: Normalized database models connecting Articles, Authors, Categories, Media Attachments, and Audit Logs.
- Accessibility Compliance: Adheres to WCAG 2.2 Level AA accessibility standards, featuring complete keyboard navigation, high contrast text ratios, and explicit image aspect ratios.
Engineering Challenges & Solutions
-
Challenge: Database Drops in Bandwidth-Constrained Environments: Occasional regional network drops risked disconnecting writers from remote PostgreSQL servers during draft creation.
Solution: Implemented a resilient persistence layer that autosaves drafts to client localStorage every 2 seconds, paired with a local atomic JSON backup adapter that enables continuous offline writing. -
Challenge: Mobile Reader Bandwidth Consumption: News readers on limited mobile bundles cannot afford multi-megabyte image downloads.
Solution: Configured Next.js Image Optimization to serve responsive WebP/AVIF formats scaled to mobile viewport widths, reducing average article payload from 3.2MB to under 280KB.