Proof of Google Cloud Deployment

This document provides evidence that KidStory: Storybook for Kids is deployed and running on Google Cloud Platform (GCP) with extensive use of Google Cloud services and APIs.

🚀 Live Application

Production URL: https://ai.kidstory.app

The application is fully deployed and operational on Google Cloud Platform, serving real users with AI-powered storybook generation.

☁️ Google Cloud Services Used

Our application leverages multiple Google Cloud services:

1. Google Cloud Run

• Service: Containerized Next.js application deployment
• Auto-scaling: Handles traffic spikes automatically
• HTTPS: Automatic SSL certificate management
• Custom Domain: Connected to ai.kidstory.app

2. Google Cloud Storage

• Bucket: storybook-for-kids-media
• Purpose: Stores generated images and audio files
• Integration: Signed URLs for secure media access

3. Google Vertex AI

• Models Used:
  • gemini-2.5-flash-image (Interleaved story + image generation)
  • gemini-2.5-flash-preview-tts (Text-to-speech narration)
  • gemini-2.5-flash (Quiz generation)
• Integration: Native Vertex AI endpoints via @google/genai SDK

4. Google Cloud Build

• CI/CD: Automated deployment pipeline
• Configuration: cloudbuild.yaml for build automation
• Integration: Direct deployment to Cloud Run

5. Firebase (Google Cloud)

• Authentication: Google OAuth integration
• Firestore: NoSQL database for user data and stories

📁 Code Evidence

Deployment Configuration

Main Deployment Guide: DEPLOYMENT.md

This comprehensive guide shows:

• Complete Google Cloud setup instructions
• Service account configuration
• Environment variables for GCP services
• Cloud Run deployment commands
• Cloud Build configuration

Key Code Files Demonstrating GCP Integration

1. Vertex AI Integration - lib/gcp/gemini.ts

   • Direct Vertex AI API calls
   • Model configuration for Gemini models
   • Streaming responses handling

2. Cloud Storage Integration - lib/gcp/storage.ts

   • File upload to Google Cloud Storage
   • Signed URL generation
   • Bucket management

3. Text-to-Speech Integration - lib/gcp/tts.ts

   • Gemini TTS model usage
   • Audio file generation and storage

4. API Routes with GCP Services:

   • app/api/generate-story/route.ts - Vertex AI story generation
   • app/api/generate-image/route.ts - Vertex AI image generation
   • app/api/generate-audio/route.ts - Vertex AI TTS integration

5. Cloud Build Configuration - cloudbuild.yaml

   • Automated deployment pipeline
   • Environment variable injection
   • Cloud Run deployment steps

🎥 Video Proof

Google Cloud Console Deployment Demo

Click the image above to watch the full deployment proof video

What the video demonstrates:

• Google Cloud Console showing active Cloud Run service
• Real-time logs from the deployed application
• Google Cloud Storage bucket with generated media files
• Vertex AI usage metrics and API calls
• Live application functionality with GCP backend

Video Link: https://www.youtube.com/watch?v=YOUR_VIDEO_ID

🔧 Technical Architecture

User Request → Cloud Run (Next.js) → Vertex AI (Gemini Models) → Cloud Storage → Response
                     ↓
              Firebase (Auth + Firestore)

Deployment Process

1. Code Push → GitHub repository
2. Cloud Build → Automated build trigger
3. Container Build → Next.js application containerization
4. Cloud Run Deploy → Automatic deployment with zero downtime
5. Domain Mapping → Custom domain (ai.kidstory.app) routing

📊 Production Metrics

The application is actively serving users with:

• Real-time story generation using Vertex AI
• Media storage in Google Cloud Storage
• User authentication via Firebase Auth
• Database operations with Firestore
• Auto-scaling based on traffic demand

🔗 Additional Resources

• Main Repository: KidStory App
• Deployment Guide: DEPLOYMENT.md
• Architecture Documentation: System Architecture
• Live Application: https://ai.kidstory.app
• Landing Page: https://kidstory.app (Deployed on Vercel)
• Documentation: https://docs.kidstory.app

✅ Verification Steps

To verify the Google Cloud deployment:

1. Visit the live application: https://ai.kidstory.app
2. Create a story to see Vertex AI in action
3. Check the deployment guide for technical implementation details
4. Review the code files mentioned above for GCP API usage
5. Watch the video proof (embedded above) showing console activity

---

This application demonstrates comprehensive Google Cloud Platform integration with multiple services working together to deliver an AI-powered storytelling experience for children.