Skip to content

DuckyDaBucky/Kori.Study

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Built at HackUTD 2025 - Kori.Study

A gentle pixel companion who studies with you, rests with you, and helps you take care of your environment.

Kori is a cozy, emotionally-aware desk companion living on a Raspberry Pi touchscreen, paired with a synchronized React Native mobile app. It observes your environment (sound, air quality, comfort signals) and reacts supportively - never judging, always present - to help you stay balanced, focused, and well-rested.


📱 React Native Mobile App - Getting Started

This is a new React Native project, bootstrapped using @react-native-community/cli.

Note: Make sure you have completed the official React Native
Environment Setup Guide before continuing.


⚡ Run Guide ⚡

Step 1 - Start Metro

Metro is the JavaScript bundler used by React Native. Start it with:

npm start
# OR
yarn start

Step 2 - Build and Run the App

Open a second terminal window at the project root.

Android

npm run android
# OR
yarn android

iOS

Before running the iOS version, install CocoaPods dependencies.

Install bundler (first time only):

bundle install

Install pods (after cloning or updating native deps):

bundle exec pod install

Run the app:

npm run ios
# OR
yarn ios

If configured correctly, the app will launch in the iOS Simulator, Android Emulator, or on a connected device.


Step 3 - Modify Your App

Open App.tsx in your editor and make changes. The app will automatically update thanks to Fast Refresh.

Force Reload

  • Android: Press R twice or open the Dev Menu with Ctrl + M (Windows/Linux) or Cmd + M (macOS)
  • iOS: Press R in the iOS Simulator

🎉 Congratulations

You have successfully launched and modified your React Native app.

Next steps could include:

  • Connecting the app to the Raspberry Pi Express backend
  • Syncing session history, environmental data, and room customization
  • Adding Gemini-powered reflective insights
  • Expanding Kori's emotional model and animations

🛠 Troubleshooting

If something does not work, refer to the official documentation:
https://reactnative.dev/docs/troubleshooting


📚 Learn More