Homework Helper AI

React Native + TypeScript app for scanning or uploading homework images and getting an AI-generated answer with step-by-step explanation.

Project Structure

src/
components/ reusable app components and React Native Reusables UI
config/ frontend API config
lib/ shared frontend helpers
schemas/ Zod schemas for frontend validation
screens/ app screens
services/ frontend API calls
styles/ NativeWind/Tailwind global CSS
types/ shared frontend types
utils/ frontend utility functions
backend/src/
config/ environment validation
middleware/ Express middleware
prompts/ AI prompts
routes/ HTTP routes
schemas/ Zod schemas and JSON schemas
services/ Gemini integration
types/ backend types
utils/ backend helpers

Run The App

npm install
npm run start

Run The Backend

cd backend
npm install
npm run dev

Create backend/.env:

GEMINI_API_KEY=your_key_here

UI

The app uses NativeWind and React Native Reusables. RNR components are copied into:

src/components/ui/

This project does not use Expo Router, so the RNR portal host is mounted in App.tsx instead of app/_layout.tsx.