🚀 StudyNova

Your Intelligent Student Study Planner & Companion

---

🌟 Overview

StudyNova is a comprehensive, full-stack application designed to help students optimize their academic schedules, track their tasks, and boost daily productivity. Powered by the Google Gemini AI, StudyNova acts as your personal AI study advisor, generating custom learning plans, study tips, and priority strategies based on your specific workload.

✨ Key Features

• 🔐 Secure Authentication: JWT-based login and registration system with Bcrypt password hashing.
• 📚 Subject & Task Management: Organize your coursework and track assignments with prioritized deadlines.
• 🕒 Timetable & Pomodoro: Built-in Pomodoro timer and interactive weekly class/study timetable.
• 🧠 AI Study Advisor: Seamless integration with Google Gemini Pro to parse your pending tasks and generate optimized, hour-by-hour study suggestions.
• 📊 Progress Analytics: Track your completion rates and academic standing.
• 📱 Cross-Platform: Built using React Native Expo, meaning it runs flawlessly on Web, iOS, and Android.

🛠️ Tech Stack

Frontend

• Framework: React Native (Expo)
• State Management: Zustand
• API Communication: Axios
• Navigation: React Navigation

Backend

• Framework: Spring Boot 3.2 (Java 17+)
• Security: Spring Security & JWT
• Database: MongoDB Atlas
• AI Integration: Custom Service wrapping Google Gemini REST APIs

🚀 Getting Started

Prerequisites

Make sure you have the following installed on your machine:

• Node.js (v18+)
• Java (JDK 17 or higher)
• Maven (For backend compilation)

1. Environment Setup

Frontend (frontend/.env):

EXPO_PUBLIC_API_BASE_URL=http://localhost:8080/api

Backend (backend/.env):

SPRING_DATA_MONGODB_URI=mongodb+srv://<your_user>:<your_password>@cluster.mongodb.net/studentplanner
GEMINI_API_KEY=your_gemini_api_key

(Note: The backend is configured with spring-dotenv to automatically load this file).

2. Running the Backend (Spring Boot)

Open a terminal in the backend/ directory and run:

mvn clean install
mvn spring-boot:run

The REST API will be available at http://localhost:8080.

3. Running the Frontend (Expo)

Open a terminal in the frontend/ directory and run:

npm install
npm run web

The application will launch in your browser at http://localhost:8081.

🧪 Testing

The backend includes comprehensive JUnit 5 and Mockito tests covering authentication, user management, and AI service resilience. To run the test suite:

cd backend
mvn clean test

📜 License & Copyright

© 2026 Isula Mihisara. All Rights Reserved.

_{Built with ❤️ for better education.}