OurTale - AI Children's Story Creator

A React Native app with Node.js backend for creating personalized children's stories using AI.

🏗️ Architecture

This is a monorepo containing:

• Frontend: React Native app with Expo (apps/mobile)
• Backend: Node.js API with tRPC (apps/backend)
• Shared: Common types, utilities, and validation (packages/*)

🚀 Quick Start

Prerequisites

• Node.js 18+
• pnpm 8+ (you have version 10 ✅)
• PostgreSQL (local or hosted)
• OpenAI API key

Installation

1. Clone and install dependencies:

git clone <repository-url>
cd ourtale
pnpm install

2. Set up environment variables:

# Backend
cp apps/backend/.env.example apps/backend/.env
# Edit apps/backend/.env with your values

# Frontend  
cp apps/mobile/.env.example apps/mobile/.env
# Edit apps/mobile/.env with your values

3. Set up database:

cd apps/backend
npx prisma generate
npx prisma db push

4. Start development servers:

# From root directory
pnpm run dev

This will start:

• Backend API on http://localhost:3000
• Mobile app with Expo dev server

📱 Development

Available Scripts

• pnpm run dev - Start all development servers
• pnpm run build - Build all packages
• pnpm run test - Run all tests
• pnpm run lint - Lint all packages
• pnpm run type-check - Type check all packages

Project Structure

ourtale/
├── apps/
│   ├── mobile/          # React Native app
│   └── backend/         # Node.js API
├── packages/
│   ├── shared-types/    # Shared TypeScript types
│   ├── shared-utils/    # Shared utilities
│   └── shared-validation/ # Shared Zod schemas
└── ...

🔧 Tech Stack

• Frontend: React Native, Expo, TypeScript, Zustand, tRPC
• Backend: Node.js, Express, tRPC, Prisma, PostgreSQL
• AI: OpenAI GPT-4, DALL-E 3
• Monorepo: Turbo, pnpm workspaces

📚 Documentation

• Architecture Plan
• API Documentation
• Mobile App Documentation

🚀 Deployment

See Deployment Guide for production setup instructions.

📄 License

MIT License - see LICENSE file for details.