TANGLAW (Tagalog for "light" or "illumination") is an AI-powered scholarship navigation portal designed for Filipino tertiary students. It combines a scholarship directory, readiness assessment, exam reviewer, and an AI chatbot companion into a single, guided dashboard experience.
Filipino tertiary students face significant barriers when searching for and applying to scholarships. According to recent data, only 30.5% of Grade 3 learners show basic reading proficiency and just 0.47% of Grade 12 learners demonstrate grade-level readiness. Scholarship research is noisy, fragmented, and difficult to navigate. Many students lack access to verified grant sources, eligibility summaries, and application support tools in one place, leaving them overwhelmed and underserved by existing resources.
TANGLAW addresses these challenges by providing a centralized, AI-powered platform that simplifies scholarship discovery and preparation. The system is a full-stack application with a Next.js frontend, Express backend, PostgreSQL database, LangChain AI integration, and Supabase hosting. Users can register, browse scholarships with advanced filtering, take readiness assessments, review exam materials, and chat with an AI companion named Owel to guide them through the application journey. The portal focuses on making scholarships easier to find, understand, and act on.
| Category | Technology |
|---|---|
| Frontend | Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS v4, Framer Motion, lucide-react |
| Backend | Express.js, TypeScript (CommonJS), Prisma v7 ORM |
| Database | PostgreSQL (Supabase), pgvector for embeddings |
| AI / LLM | Google Gemini 3.1 Flash-Lite (primary), OpenRouter free models (fallback cascade), LangChain |
| Authentication | NextAuth.js v4 (Credentials, Google, Microsoft Entra), JWT (jsonwebtoken + bcryptjs) |
| Testing | Vitest (unit), Playwright (E2E) |
| Deployment | Vercel (frontend), Render (backend), Supabase (database) |
| Package Manager | npm |
- Scholarship Browser — Search and filter scholarships by income bracket, sector (public/private), and program category with eligibility recommendations
- Readiness Assessment — Timed multi-subject quiz covering Math, Science, English, Filipino, and Logic
- Exam Reviewer — Review practice questions with explanations and difficulty levels
- AI Chatbot Companion — Owel, an AI-powered assistant using RAG (Retrieval-Augmented Generation) to answer scholarship-related queries
- Secure Student Dashboard — Protected routes with NextAuth.js authentication and JWT-based API access
- Responsive UI — Animated, accessible interface built with Framer Motion and Tailwind CSS
- Node.js 20 or later
- npm
- A Supabase account (for PostgreSQL database)
cd backend
npm install
npx prisma generate
npx prisma db push
npm run seed
npm run devThe backend runs on http://localhost:5000.
cd frontend
npm install
npm run devThe frontend runs on http://localhost:3000.
# TypeScript typecheck
cd frontend && npx tsc --noEmit
# Lint
cd frontend && npm run lint
# Unit tests
cd frontend && npx vitest run
# E2E tests (requires running dev server)
npx playwright testtanglaw/
├── frontend/ — Next.js 16 App Router (deployed on Vercel)
│ ├── src/app/ — Pages and API routes
│ │ ├── (auth)/ — Login and signup pages
│ │ ├── dashboard/ — Authenticated dashboard (scholarships, readiness, reviewer)
│ │ ├── api/ — Chat API and NextAuth handler
│ │ └── page.tsx — Landing page
│ ├── src/components/ — UI components (scholarship browser, chatbot, quiz)
│ └── src/lib/ — API client, auth config, AI model tools
│
├── backend/ — Express API (deployed on Render)
│ ├── src/
│ │ ├── controllers/ — Auth, scholarship, and chat controllers
│ │ ├── middleware/ — JWT authentication middleware
│ │ ├── routes/ — API route definitions
│ │ └── services/ — Prisma client, chat service, scholarship search
│ ├── prisma/ — Database schema (source of truth) and seed data
│ └── start.sh — Render deploy script
│
├── CLAUDE.md — Project context for AI assistants
├── DESIGN.md — Design system specification
├── PRODUCT.md — Product vision and brand personality
├── DEPLOY.md — Full deployment guide (Vercel + Render + Supabase)
└── render.yaml — Render Blueprint configuration
This project is intended for academic and project submission use.
| Portrait | Member & role | Contribution | Profile | GitHub |
|---|---|---|---|---|
![]() |
Godsent John C. Salvaloza Documentation Head |
Oversees all paper sections, references indexation, and final compiled academic paper validation. | — | — |
![]() |
Rhaine Venice B. Bonador Introduction Writer |
Handles Chapter 1 problem contexts, general socioeconomic gaps, and solution frameworks. | — | GitHub |
![]() |
Kyle Ashley B. Madera Statement of the Problem Writer |
Transforms operational goals into measurable research questions, metrics, and study definitions. | — | GitHub |
![]() |
Hannah Mae V. Alberto RRL Lead Writer |
Manages literature review synthesis, source curation, and academic narrative alignment. | — | GitHub |
![]() |
Hannah Nicole B. Partible RRL Assistant & Citation Checker |
Maintains reference accuracy, citation formatting, and academic consistency. | — | GitHub |
![]() |
Emerald T. Perez Methodology Writer |
Structures the research design, evaluation method, and analytical process. | — | GitHub |
![]() |
Julliane Mae G. Araullo Results Writer |
Compiles findings, performance metrics, and usability impact narratives. | GitHub | |
![]() |
Daniel F. Pajares Discussion Writer |
Explains implications, limitations, and future recommendations of the project. | — | GitHub |
| Portrait | Member & role | Contribution | Profile | GitHub |
|---|---|---|---|---|
![]() |
Bennett P. Payoyo Project Manager |
Directs operational scope, research alignment, task delegation, and final deployment quality gates. | GitHub | |
![]() |
An-joe Mikael T. Albano Frontend Developer |
Leads interface delivery, motion polish, and responsive behavior. | GitHub | |
![]() |
Levrone Viel S. Delos Reyes Frontend & QA |
Supports UI quality checks, interaction validation, and accessibility review. | — | GitHub |
![]() |
Charles Joseph V. Faustino Backend Developer & Database Manager |
Builds server interactions, data flow structure, and simulated persistence pathways. | GitHub | |
![]() |
Justin Angelo G. Cruz QA Tester / Technical Documentation |
Manages test matrices, documentation clarity, and final feature verification. | — | GitHub |
Institution: Polytechnic University of the Philippines (PUP Manila) — BSCS 1-2, Science, Technology, and Society (STS)












