moha2005269/masari-platform

Masari is a web application designed to help students and young professionals in Saudi Arabia and the Arab Gulf region plan their academic and career paths. The platform combines career personality testing, academic readiness checks, and an AI-powered counseling chatbot into a single interface. It supports both Arabic and English throughout. The AI features are powered by Google Gemini 2.5 Flash, a large language model from Google. When a user asks for career or academic guidance, the app sends the question to Google's API along with instructions to respond in the user's chosen language. The model can also pull in live information from the web, such as current job vacancy counts and salary data, using Google Search integration. Users create accounts and are given a points balance (starting at 50) that gets spent when they use AI-powered tools. A simulated payment flow lets users buy more points or upgrade to a paid tier. The platform stores user profiles, test results, and saved AI-generated reports in Firebase, Google's cloud database. The main tools include a 50-question RIASEC career personality test (a standardized framework for matching personality types to career fields), an academic readiness diagnostic, a salary estimator, and a university admissions helper that references entry score thresholds for Saudi universities. The platform includes data on over 100 academic majors and multiple Saudi universities. The interface uses an animated 3D visual style with cursor-tracking card tilts and bold styling. The frontend is built with React, Tailwind CSS, and Vite. To run the project, developers need to supply their own Firebase project credentials and a Google Gemini API key via a .env file. The project is licensed under the MIT license, which allows free use for any purpose.