# Masari Employee Portal

Case study by Devansh Tiwari (https://www.devanshtiwari.com) · https://www.devanshtiwari.com/work/masari-portal

Bilingual intranet for a Saudi government entity. 33 pages, 1,800+ translation keys, sole frontend dev.

## Key facts

- Role: Sole Frontend Developer
- Client: OSIT / Masari
- Year: 2024
- Status: Shipped
- Tech: React, TypeScript, Redux Toolkit, Tailwind CSS, shadcn/ui, Strapi CMS, i18next, ADFS SSO, Tiptap

## At a glance

- Problem: SharePoint couldn't handle Arabic-first layouts or this entity's own workflows.
- What I built: A bilingual intranet with 33 pages for announcements, documents and onboarding.
- Result: Staff work in Arabic or English on one portal built around their own workflows.

## Numbers

| Metric | Value |
| --- | --- |
| Employees served | 500+ |
| Pages | 33 |
| Translation keys | 1,800+ |
| Duration | 6 months |

Values with a + are public figures rounded down.

## The problem

A Saudi government entity working on a Vision 2030 mega-project needed a custom portal for 500+ employees. SharePoint failed on two fronts: Arabic-first UX with proper RTL layout, and domain-specific workflows like visual announcement creation and compliance tracking.

## What I built

33 pages covering the full employee lifecycle. Announcement canvas creator where comms staff pick templates, choose dimensions, write bilingual content through a rich text editor, and export to PNG. Document management with in-browser PDF viewer. Microsoft ADFS SSO with local fallback. Multi-step onboarding flow with compliance tracking. Notification system with infinite scroll. Full Arabic/English RTL with 1,800+ translation keys.

### Announcement Canvas Creator

Comms staff pick from 6 templates, set dimensions, write bilingual Arabic/English content in a rich text editor (Tiptap), and export to PNG for digital signage or email. Templates include event posters, policy updates, achievement announcements, and holiday notices. All exports are retina-ready at 2x resolution.

### Document Management

In-browser PDF viewer with search, zoom, and annotation. Documents are organized by department and access level. Version history tracks who uploaded what and when. Microsoft ADFS SSO integration means employees access documents with their existing corporate credentials. Local fallback auth for contractors without AD accounts.

### Onboarding & Compliance

Multi-step onboarding flow: personal info, department assignment, asset allocation, compliance acknowledgments, and training schedule. Compliance tracking shows which employees have signed which policies and flags overdue acknowledgments. Managers get a dashboard view of their team's compliance status.

### Notification System

Infinite scroll notification feed with category filters (announcements, tasks, alerts). Real-time updates via WebSocket push. Notification preferences let users choose which categories trigger push, email, or in-app badges. Unread count persists across sessions.

## Work with Devansh

Devansh Tiwari is an AI product engineer based in India, available for freelance and consulting work: custom data feeds from sites without APIs, AI features (agents, chat, RAG, MCP servers) built on that data, and running them after launch.

- Book a 15 minute call: https://cal.com/devansh0718/15min
- Email: devanshtiwari365@gmail.com
- All case studies: https://www.devanshtiwari.com/work
- Site summary for AI tools: https://www.devanshtiwari.com/llms.txt
