StoryQuest - AI Interactive Story App

StoryQuest is a complete interactive story app, not a UI kit. Players read branching stories, make choices that change the plot, and reach one of several endings. You write and manage content from an in-app admin authoring tool that can generate scene art and choice text with AI. Everything runs on Supabase with Row-Level Security and server-side economy logic.

LIVE DEMO https://storyquest-demo.vercel... Login: demo@storyquest.app / StoryDemo2026 (Web demo. The same code builds native Android and iOS apps.)

PLAYER FEATURES - Story library with genre, tagline, read time and cover art - Cinematic player: Ken Burns background zoom, typewriter text, vignette, chapter transitions - Branching choices with good / neutral / bad / critical outcomes - Multiple endings per story, endings tracker, achievements, daily challenge - Multiple save slots per story - Per-genre background music (bring your own tracks) - Email/password and Google sign-in, password reset, account deletion

MONETIZATION (ALL SERVER-VERIFIED) - Coin economy: free first chapter, coin-gated chapters - Free hourly coin and rewarded ads (AdMob) with replay-proof server grants - Coin packs and premium subscription via RevenueCat, granted only by a signed webhook

ADMIN AUTHORING TOOL (IN THE APP) - Create and edit stories, chapters, scenes, characters and choices - Generate backgrounds with Replicate Flux and choices with DeepSeek through Edge Functions - AI keys never reach the client; every function checks admin status and is rate-limited

BUILT PROPERLY - Row-Level Security on every table; privileged columns only writable through SECURITY DEFINER RPCs - 23 ordered migrations, 5 Edge Functions, demo story with 13 AI-generated images - Provider/service architecture, unit tests, optional Sentry - flutter analyze clean

WHAT'S INCLUDED - Full Flutter source (Android, iOS, Web) - Supabase migrations, Edge Functions, demo story and artwork - Step-by-step setup guide (about 15 minutes to first run) - Rebranding guide and changelog

REQUIREMENTS - Flutter 3.44 or newer - Free Supabase account - Optional: AdMob, RevenueCat, Replicate, DeepSeek accounts for those features

NOT INCLUDED Music tracks, story content beyond the demo, API keys.

SUPPORT Setup questions and bug reports through the item comments, usually answered within 48 hours.

CHANGELOG 1.0.0 (18 Sep 2026) - Initial release.

Features

• Branching stories with good / neutral / bad / critical choices and multiple labelled endings
• Cinematic player: Ken Burns backgrounds, typewriter text, character portraits, chapter transitions
• Coin economy: free first chapter, coin-gated chapters, hourly free coin
• Rewarded ads (AdMob) with server-verified, replay-proof grants
• Coin packs and premium subscription via RevenueCat webhook
• In-app admin authoring tool: stories, chapters, scenes, characters, choices
• AI generation of scene art (Replicate Flux) and choices (DeepSeek) via Edge Functions
• Multiple save slots, achievements, daily challenge, endings tracker
• Email/password and Google sign-in, password reset, account deletion
• Row-Level Security on every table, 23 ordered migrations, unit tests
• One codebase for Android, iOS and Web; demo story with 13 images included

Requirements

1. Flutter 3.44 or newer
2. Free Supabase account
3. Optional: AdMob, RevenueCat, Replicate and DeepSeek accounts (only for ads, purchases and the AI authoring buttons)

Instructions

1. Create a free Supabase project.
2. Run the SQL files in supabase/migrations/ in order (or `supabase db push`).
3. Run supabase/seed/demo_story.sql, upload supabase/seed/demo_art/ to Storage, run demo_story_art.sql.
4. Put your project URL and publishable key in lib/config/supabase_config.dart. 
5. Run `flutter pub get`, then `flutter run`. Full guide with Google sign-in, AdMob, RevenueCat and AI setup: docs/SETUP.md inside the package.