# Project export: DOMO

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: CruzHacks 2026
- Tagline: A cozy focus timer to help you and your digital pet thrive! Completing study sessions keeps you and your pet happy and healthy. End each session with reflections so progress feels meaningful.
- Devpost: https://devpost.com/software/pomo-nxzv73
- GitHub: https://github.com/suaviloquence/domo.git
- Video: https://www.youtube.com/embed/dU2Mu-H0x7g?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent
- Result: winner (Best UI/UX Hack)
- Team: 3 GitHub contributor(s) — joeyhuangg (21 commits), huangamber (13 commits), m (11 commits)

## Devpost submission (written by the team)

### Inspiration

We wanted to make studying feel fun instead of boring, inspired by the idea of raising a virtual pet and being able to care for and customize it as you go. We also valued mechanisms in study tools that allow users to keep track of their work and make progress feel meaningful and fulfilling. By caring for an animal and customizing it over time, studying feels less boring and more rewarding. That’s where our name comes from: DOMO (pronounced “doh-moh”). It plays on the phrase “do more,” but in a gentler way, encouraging progress without pressure!

### What it does

DOMO allows you to set a focus goal and a timer. Once started, the app will keep you locked in to focus on your goals. After completing a successful study session, you earn in-game currency and write a quick reflection about what you accomplished, still need to do, and just help you keep track of your tangible progress. The app will also reward you with currency once the timer ends, which you can use to buy accessories for your pet once. This serves as a way to help keep you motivated to follow through with study sessions by giving you rewards.

### How we built it

We built DOMO as a mobile app using React Native and Xcode to develop and test the iOS version. The app is structured around multiple screens, including onboarding, home, focus timer, shop, and reflection logs We used component-based design to keep UI elements reusable and organized Shared state is managed through context to track the pet’s status, in-app currency, and study session progress Navigation between screens is handled through a stack-based flow to create a smooth and intentional user experience

### Challenges we ran into

This was also our first time building an iOS app, so there was a learning curve in figuring out mobile workflows, navigation, and debugging issues we hadn’t run into before. A lot of the process involved trial and error, Googling, and learning on the fly. Finally, like most hackathons, we had to balance big ideas with limited time. We had many features we wanted to add, but learning how to scope realistically and focus on what mattered most was a challenge in itself.

### Accomplishments we're proud of

Amber: Designing and rendering all the characters, accessories, and almost all the assets in the app during the short time frame! Joey: Learning how to build an IOS app for the first time + closet feature! 😎 Max: Building an iOS app for the first time! Manuel: Sourcing sound effects and finding creative ways to enrich user experience.

### What we learned

Building DOMO taught us that productivity tools aren’t just about timers or tracking data — motivation is emotional. When focus is paired with encouragement, rewards, and reflection, it feels less stressful and more sustainable, especially for students. This was also the first time both Max and Joey built an iOS app. We learned how to break a larger idea into achievable pieces, debug unfamiliar mobile workflows, and make intentional design decisions under time pressure. Along the way, we explored how to effectively use AI as a development tool. From brainstorming features to troubleshooting issues, we learned how AI can speed up development while still requiring thoughtful human judgment and iteration!

### What's next

We want DOMO to grow into a long-term study companion that supports focus while staying fun and low-pressure! We hope to implement the following: Accessibility to everyone, including Android users 🙈 Screen time locks or app usage monitoring during study sessions Adjustable studying intensity so users can control how fast their pet gets hungry or progresses Built-in background music, ambient sounds, and custom sound effects More accessories and backgrounds in the shop Pet evolutions tied to long-term consistency More interactions with the pet, such as petting or playing Our goal is to make studying feel more rewarding and personal, rather than stressful or rigid!

## README (from the GitHub repository)

This is a new [**React Native**](https://reactnative.dev) project, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).

# Getting Started

> **Note**: Make sure you have completed the [Set Up Your Environment](https://reactnative.dev/docs/set-up-your-environment) guide before proceeding.

## Step 1: Start Metro

First, you will need to run **Metro**, the JavaScript build tool for React Native.

To start the Metro dev server, run the following command from the root of your React Native project:

```sh
# Using npm
npm start

# OR using Yarn
yarn start
```

## Step 2: Build and run your app

With Metro running, open a new terminal window/pane from the root of your React Native project, and use one of the following commands to build and run your Android or iOS app:

### Android

```sh
# Using npm
npm run android

# OR using Yarn
yarn android
```

### iOS

For iOS, remember to install CocoaPods dependencies (this only needs to be run on first clone or after updating native deps).

The first time you create a new project, run the Ruby bundler to install CocoaPods itself:

```sh
bundle install
```

Then, and every time you update your native dependencies, run:

```sh
bundle exec pod install
```

For more information, please visit [CocoaPods Getting Started guide](https://guides.cocoapods.org/using/getting-started.html).

```sh
# Using npm
npm run ios

# OR using Yarn
yarn ios
```

If everything is set up correctly, you should see your new app running in the Android Emulator, iOS Simulator, or your connected device.

This is one way to run your app — you can also build it directly from Android Studio or Xcode.

## Step 3: Modify your app

Now that you have successfully run the app, let's make changes!

Open `App.tsx` in your text editor of choice and make some changes. When you save, your app will automatically update and reflect these changes — this is powered by [Fast Refresh](https://reactnative.dev/docs/fast-refresh).

When you want to forcefully reload, for example to reset the state of your app, you can perform a full reload:

- **Android**: Press the <kbd>R</kbd> key twice or select **"Reload"** from the **Dev Menu**, accessed via <kbd>Ctrl</kbd> + <kbd>M</kbd> (Windows/Linux) or <kbd>Cmd ⌘</kbd> + <kbd>M</kbd> (macOS).
- **iOS**: Press <kbd>R</kbd> in iOS Simulator.

## Congratulations! :tada:

You've successfully run and modified your React Native App. :partying_face:

### Now what?

- If you want to add this new React Native code to an existing application, check out the [Integration guide](https://reactnative.dev/docs/integration-with-existing-apps).
- If you're curious to learn more about React Native, check out the [docs](https://reactnative.dev/docs/getting-started).

# Troubleshooting

If you're having issues getting the above steps to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.

# Learn More

To learn more about React Native, take a look at the following resources:

- [React Native Website](https://reactnative.dev) - learn more about React Native.
- [Getting Started](https://reactnative.dev/docs/environment-setup) - an **overview** of React Native and how setup your environment.
- [Learn the Basics](https://reactnative.dev/docs/getting-started) - a **guided tour** of the React Native **basics**.
- [Blog](https://reactnative.dev/blog) - read the latest official React Native **Blog** posts.
- [`@facebook/react-native`](https://github.com/facebook/react-native) - the Open Source; GitHub **repository** for React Native.


## Detected evidence (automated analysis)

Indexed codebase: 39 recognized source files, 125 KB.
- JavaScript (language) — detected in the code
- Kotlin (language) — detected in the code
- React (technology) — detected in the code
- Swift (language) — detected in the code
- TypeScript (language) — detected in the code

## Codebase structure (from repository index)

### Files (67 of 67)

```
__tests__/App.test.tsx
.bundle/config
.eslintrc.js
.gitignore
.prettierrc.js
.watchmanconfig
android/app/build.gradle
android/app/debug.keystore
android/app/proguard-rules.pro
android/app/src/main/AndroidManifest.xml
android/app/src/main/java/com/thewhitemonster/MainActivity.kt
android/app/src/main/java/com/thewhitemonster/MainApplication.kt
android/app/src/main/res/drawable/rn_edit_text_material.xml
android/app/src/main/res/values/strings.xml
android/app/src/main/res/values/styles.xml
android/build.gradle
android/gradle.properties
android/gradle/wrapper/gradle-wrapper.properties
android/gradlew
android/gradlew.bat
android/settings.gradle
app.json
App.tsx
babel.config.js
Gemfile
index.js
ios/.xcode.env
ios/Podfile
ios/Podfile.lock
ios/thewhitemonster.xcodeproj/project.pbxproj
ios/thewhitemonster.xcodeproj/xcshareddata/xcschemes/thewhitemonster.xcscheme
ios/thewhitemonster.xcworkspace/contents.xcworkspacedata
ios/thewhitemonster/AppDelegate.swift
ios/thewhitemonster/Images.xcassets/AppIcon.appiconset/Contents.json
ios/thewhitemonster/Images.xcassets/Contents.json
ios/thewhitemonster/Info.plist
ios/thewhitemonster/LaunchScreen.storyboard
ios/thewhitemonster/PrivacyInfo.xcprivacy
jest.config.js
metro.config.js
package.json
README.md
src/assets/fireStreak
src/components/ActionButtonRow.tsx
src/components/HungerBar.tsx
src/components/MainActionButton.tsx
src/components/MeterBar.tsx
src/components/PetDisplay.tsx
src/components/RateSessionModal.tsx
src/components/ReflectionModal.tsx
src/components/SevenSegmentTimer.tsx
src/components/StartTimerFlow.tsx
src/components/StatusBarSection.tsx
src/components/TimerModal.tsx
src/context/PetContext.tsx
src/data/items.ts
src/notifications.ts
src/screens/CompletionScreen.tsx
src/screens/FocusScreen.tsx
src/screens/HomeScreen.tsx
src/screens/JournalScreen.tsx
src/screens/PickPetScreen.tsx
src/screens/SettingsScreen.tsx
src/screens/ShopScreen.tsx
src/screens/SplashScreen.tsx
src/useFocusGuard.tsx
tsconfig.json
```

### Dependencies

- package.json: @babel/core@^7.25.2, @babel/preset-env@^7.25.3, @babel/runtime@^7.25.0, @react-native-async-storage/async-storage@^2.2.0, @react-native-community/cli@20.0.0, @react-native-community/cli-platform-android@20.0.0, @react-native-community/cli-platform-ios@20.0.0, @react-native/babel-preset@0.83.1, @react-native/eslint-config@0.83.1, @react-native/metro-config@0.83.1, @react-native/new-app-screen@0.83.1, @react-native/typescript-config@0.83.1, @react-navigation/native@^7.1.28, @react-navigation/native-stack@^7.10.0, @types/jest@^29.5.13, @types/react@^19.2.0, @types/react-native-vector-icons@^6.4.18, @types/react-test-renderer@^19.1.0, eslint@^8.19.0, jest@^29.6.3, prettier@2.8.8, react@19.2.0, react-native@0.83.1, react-native-notifications@^5.2.2, react-native-safe-area-context@^5.6.2, react-native-screens@^4.19.0, react-native-vector-icons@^10.3.0, react-test-renderer@19.2.0, tslib@^2.8.1, typescript@^5.8.3

### Recent commits (newest first)

- icons
- more polishes
- my polishes
- Rugy has been made the icon for the splash screen
- BACKGROUND ITS DONE ITS DONE
- Deleted old Rugy.png
- more polishes
- journal with background
- new rugy flower
- Rename flame-iconreal-removebg-preview.png to fireStreak
- Add files via upload
- fixes and polishes
- closet icon
- journal button
- feat: add hunger system with food inventory and dev controls
- food icon
- THIS THE REAL HEALTHBAR
- healthbar
- dev tools n hunger
- merge: sync with origin/main

## Key source files (fetched from GitHub, selected and truncated for size)

### Gemfile

```
source 'https://rubygems.org'

# You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
ruby ">= 2.6.10"

# Exclude problematic versions of cocoapods and activesupport that causes build failures.
gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
gem 'xcodeproj', '< 1.26.0'
gem 'concurrent-ruby', '< 1.3.4'

# Ruby 3.4.0 has removed some libraries from the standard library.
gem 'bigdecimal'
gem 'logger'
gem 'benchmark'
gem 'mutex_m'

```

### package.json

```
{
  "name": "thewhitemonster",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "android": "react-native run-android",
    "ios": "react-native run-ios",
    "lint": "eslint .",
    "start": "react-native start",
    "test": "jest"
  },
  "dependencies": {
    "@react-native-async-storage/async-storage": "^2.2.0",
    "@react-native/new-app-screen": "0.83.1",
    "@react-navigation/native": "^7.1.28",
    "@react-navigation/native-stack": "^7.10.0",
    "react": "19.2.0",
    "react-native": "0.83.1",
    "react-native-notifications": "^5.2.2",
    "react-native-safe-area-context": "^5.6.2",
    "react-native-screens": "^4.19.0",
    "react-native-vector-icons": "^10.3.0",
    "tslib": "^2.8.1"
  },
  "devDependencies": {
    "@babel/core": "^7.25.2",
    "@babel/preset-env": "^7.25.3",
    "@babel/runtime": "^7.25.0",
    "@react-native-community/cli": "20.0.0",
    "@react-native-community/cli-platform-android": "20.0.0",
    "@react-native-community/cli-platform-ios": "20.0.0",
    "@react-native/babel-preset": "0.83.1",
    "@react-native/eslint-config": "0.83.1",
    "@react-native/metro-config": "0.83.1",
    "@react-native/typescript-config": "0.83.1",
    "@types/jest": "^29.5.13",
    "@types/react": "^19.2.0",
    "@types/react-native-vector-icons": "^6.4.18",
    "@types/react-test-renderer": "^19.1.0",
    "eslint": "^8.19.0",
    "jest": "^29.6.3",
    "prettier": "2.8.8",
    "react-test-renderer": "19.2.0",
    "typescript": "^5.8.3"
  },
  "engines": {
    "node": ">=20"
  }
}

```

### index.js

```javascript
/**
 * @format
 */

import { AppRegistry } from 'react-native';
import App from './App';
import { name as appName } from './app.json';

AppRegistry.registerComponent(appName, () => App);

```

### App.tsx

```typescript
import React, { useEffect } from 'react';
import { StatusBar } from 'react-native';
import { NavigationContainer } from '@react-navigation/native';
import { createNativeStackNavigator } from '@react-navigation/native-stack';
import { requestPermission } from './src/notifications';

import HomeScreen from './src/screens/HomeScreen';
import SplashScreen from './src/screens/SplashScreen';
import PickPetScreen from './src/screens/PickPetScreen';
import FocusScreen from './src/screens/FocusScreen';
import ShopScreen from './src/screens/ShopScreen';
import JournalScreen from './src/screens/JournalScreen';
import SettingsScreen from './src/screens/SettingsScreen';

import { PetProvider, usePet } from './src/context/PetContext';
import CompletionScreen from './src/screens/CompletionScreen';

const Stack = createNativeStackNavigator();

function RootNavigator() {
  const { selectedPetId, isReady } = usePet();

  if (!isReady) return <SplashScreen />;

  return (
    <Stack.Navigator
      screenOptions={{ headerShown: false }}
      initialRouteName={selectedPetId ? 'Home' : 'PickPet'}
    >
      <Stack.Screen name="PickPet" component={PickPetScreen} />

      <Stack.Screen name="Home" component={HomeScreen} />
      <Stack.Screen name="Focus" component={FocusScreen} />
      <Stack.Screen name="Shop" component={ShopScreen} />
      <Stack.Screen name="Completion" component={CompletionScreen} />
      <Stack.Screen name="Journal" component={JournalScreen} />
      <Stack.Screen name="Settings" component={SettingsScreen} />
    </Stack.Navigator>
  );
}

export default function App() {
  useEffect(() => {
    requestPermission();
  }, []);

  return (
    <PetProvider>
      <NavigationContainer>
        <RootNavigator />
      </NavigationContainer>
    </PetProvider>
  );
}

```

### jest.config.js

```javascript
module.exports = {
  preset: 'react-native',
};

```

### .eslintrc.js

```javascript
module.exports = {
  root: true,
  extends: '@react-native',
};

```

### babel.config.js

```javascript
module.exports = {
  presets: ['module:@react-native/babel-preset'],
};

```

### .prettierrc.js

```javascript
module.exports = {
  arrowParens: 'avoid',
  singleQuote: true,
  trailingComma: 'all',
};

```

### metro.config.js

```javascript
const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

/**
 * Metro configuration
 * https://reactnative.dev/docs/metro
 *
 * @type {import('@react-native/metro-config').MetroConfig}
 */
const config = {};

module.exports = mergeConfig(getDefaultConfig(__dirname), config);

```

### __tests__/App.test.tsx

```typescript
/**
 * @format
 */

import React from 'react';
import ReactTestRenderer from 'react-test-renderer';
import App from '../App';

test('renders correctly', async () => {
  await ReactTestRenderer.act(() => {
    ReactTestRenderer.create(<App />);
  });
});

```

[30 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]