Study Pet is a React Native Expo application designed to help students manage their study time effectively. The app's goal is to encouraging students to study by tying the care of a virtual pet to their study habits, the more they study the happier their pet will be and the better it will grow.
Before you begin, ensure you have met the following requirements:
- You have installed the latest version of Node.js and npm
- You have installed Expo CLI:
npm install -g expo-cli - You have a Windows/Mac/Linux machine.
To install Study Pet, follow these steps:
- Clone the repository:
git clone https://github.com/uprm-inso4117-2023-2024-s2/semester-project-study-pet.git - Navigate into the project directory:
cd semester-project-study-pet - Install dependencies:
npm install
To use Study Pet follow these steps:
- Start the Expo server:
npx expo start
- Make sure you have Android Studio installed.
- Setup an Android Virtual Device (AVD) in Android Studio. You can follow the instructions here.
- Run the AVD.
- Press
ain your terminal after starting the Expo server to send the app to your Android emulator.
- Make sure you have Xcode installed.
- Setup an iOS simulator in Xcode. You can follow the instructions here.
- Press
iin your terminal after starting the Expo server to send the app to your iOS simulator.
- Open the Expo client app on your iOS or Android phone.
- Scan the QR code printed by
npx expo startwith Expo Go (Android) or the Camera app (iOS).
To run tests:
- Run the project on Phone or Web
- Find file name of the test (located in
_tests_/) - Run
npx jest "filename"in the terminal
- You can create pets and assign them specific assignments so they can help you study! You can choose from a variety of pets, including a Frog, a Penguin, A Dog, a Cat, and more! All with unique designs and expressions!
To keep your pet healthy, clean, and entertained, play minigames which help you study for your assignments! Among these:
-
Bathing Minigame: Depending on chosen difficulty, you get 3-9 questions. Depending on how many you get correct you get to boost your pets happiness stat!
-
Eating Minigame: Your pet grows hungry over time, keep it satiated by partaking in a multiple choice flashcards minigame!
-
Playing Minigame: To keep your pet happy, play with it frequently by answering questions correctly in another multiple choice flashcards minigame!
- Special sound effects for minigames
- Pet customization options
- Shop to give your pet food and other items!
- Stat menu to keep track of your pets
- Mobile notifications to remind you of your Studypet!
- Flashcard minigame creation and editing to suit your studying needs!
- And so much more!
TODO: Add license