A Laravel + Inertia application that generates personalized stories for kids, complete with text-to-speech narration. Built as a native iOS application using NativePHP.
⚠️ Important Notice: This application is currently not functioning within NativePHP iOS due to pending storage system fixes from the NativePHP team. The web version works perfectly, and we'll update this notice once NativePHP resolves the storage system issues.
View full demo video (With Audio)
- 🎨 Story generation using LLM (powered by Prism)
- 🗣️ Text-to-speech narration using ElevenLabs
- 📱 Native iOS experience with NativePHP
- 🎭 Customizable story elements (animals, emotions, etc.)
- 🔒 User authentication system (It exists through the VueJS Laravel Starterkit but its not being used, you can uncomment out routes in
web.php)
- PHP 8.2 or higher
- Node.js & NPM
- Composer
- macOS (for iOS development)
- ElevenLabs API key
- Prism API key
- A NativePHP Mobile license
- Clone the repository:
git clone <repository-url>
cd <repository-name>- Install PHP dependencies:
composer install- Install Node.js dependencies:
npm install- Create environment file:
cp .env.example .env- Generate application key:
php artisan key:generate- Configure your database in
.envfile and run migrations:
php artisan migrate- Seed the database with basic story elements:
php artisan db:seed- To run on NativePHP Check out: The Native PHP Docs
The application's story generation settings can be configured in config/story.php:
max_story_length: Maximum character length for generated stories (default: 100)default_llm_provider: Default LLM provider (Groq)default_llm_model: Default model for story generation (deepseek-r1-distill-qwen-32b)eleven_labs_voices: Configuration for text-to-speech voicesdutch_voice_id: Dutch voice ID (Dirk - requires Pro subscription)english_voice_id: English voice ID (Rachel)
eleven_labs_model: Text-to-speech model versioneleven_labs_api_key: Your ElevenLabs API key (set in .env)
Make sure to set the following in your .env file:
# App Configuration
APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
# Database Configuration
DB_CONNECTION=sqlite
# API Keys for LLM and Voice Generation
ELEVEN_LABS_API_KEY=your_elevenlabs_key_here
GROQ_API_KEY=your_groq_key_here
# NativePHP Configuration
NATIVEPHP_AXIOS=false
The application requires:
- Groq API Key: Used by Prism for LLM story generation with the deepseek-r1-distill-qwen-32b model. Alternatively check out PrismPHP which allows for more model providers
- ElevenLabs API Key: Required for text-to-speech voice generation
- NativePHP Axios: Needs to be
trueis trying to run on an iOS device (replaces axios with iOS specific axios for intertia) - SQLite Database: The application uses SQLite by default to allow for on device database
To start the development server:
npm run devFor iOS development:
Check out: The Native PHP Docs
The application comes with basic story elements pre-configured in the database seeder:
- Animal types (Sheep, Turtle)
- Emotion types (Happy, Sad)
You can modify or add more elements in database/seeders/StoryElementTableSeeder.php.
- Laravel 12
- Inertia.js
- NativePHP
- Prism PHP (for LLM integration)
- ElevenLabs (for text-to-speech)
- TypeScript
- Tailwind CSS
Copyright 2025 - FlowBridgeAI, Inc.
Licensed under the Apache License, Version 2.0 (the "License") with the following limitations:
- You may use or modify the software only for your own internal business purposes or for non-commercial or personal use.
- You may distribute the software or provide it to others only if you do so free of charge for non-commercial purposes.
- You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software.
- Any use of the licensor's trademarks is subject to applicable law.