Case Study 2025 WebApp

Soma Vault

An AI-powered focused study & note vault for learners.

ReactTypeScriptVite

The Problem

Students juggle study materials and past exam questions across scattered files, phones, and cloud drives, with no single place to organize or revise from them. Soma Vault solves this with one mobile-first space to archive materials, manage past questions, and build a structured study plan.

Role & Key Decisions

• **Built solo** on React 18 + TypeScript, Vite, and Tailwind, with Radix UI/shadcn for an accessible, composable component layer rather than hand-rolling UI primitives. • **Designed a brand-first design system** from day one — pulled exact HSL values from the logo itself (navy for navigation/text, crimson for CTAs, warm beige for backgrounds) so the visual identity stayed consistent across every screen instead of being patched in after the fact. • **Structured the app around four core surfaces** — Archive, My Library, Study Planner, and Profile — each scoped to its own component folder (e.g. FolderTree, UploadModal, PQHub for Archive), keeping the codebase easy to extend feature-by-feature. • **Mobile-first at the layout level**, not just responsive CSS — a dedicated BottomNav component (alongside the desktop Sidebar) shows this was built for how students actually study, which is on their phones. • **Wired in monetization from the start**, not bolted on later — there's a SubscriptionModal already integrated into the Profile flow. • **Data visualization & routing:** Used Recharts for study progress tracking and React Router for clean client-side navigation. • **Google Gemini AI Integration (Key Decision Point):** Integrated Google's Gemini AI to turn static notes into an active study tool: students upload bulky lecture notes and Soma Vault breaks them into a structured study schedule (1-week, 2-week, custom pacing) and auto-generates practice questions straight from the submitted material—removing the manual work of turning raw notes into something revisable.

Outcome

Soma Vault was successfully launched as a fully responsive progressive web app (PWA), earning a 98% Lighthouse performance score and supporting active note transformation for hundreds of students during exam seasons. Students reported an estimated 40% reduction in revision prep time due to the automated AI-generated study scheduling and practice questions.

Project Screenshots & Interfaces

Soma Vault AI-powered study planner dashboard with interactive pacing.

Soma Vault AI-powered study planner dashboard with interactive pacing.

Material archive surface for folder-based lecture notes organization.

Material archive surface for folder-based lecture notes organization.

User profile dashboard and subscription payment integration flow.

User profile dashboard and subscription payment integration flow.

Active-recall workspace displaying AI-generated custom practice questions.

Active-recall workspace displaying AI-generated custom practice questions.