Skip to content

bhoraniaarshadali/story-tales-teach

Repository files navigation

Story Tales Teach

Overview

Story Tales Teach is an educational web application designed to make learning fun and memorable by generating engaging Hinglish stories that explain complex topics. The platform leverages AI technology to create personalized narratives, making concepts easier to understand for a diverse, bilingual audience.

Core Value Proposition

  • Converts complex concepts into simple, engaging Hinglish stories
  • Makes learning interactive and culturally relevant
  • Offers audio narration for accessibility
  • Maintains a history of user-generated stories

Target Audience

  • Students seeking alternative learning methods
  • Educators looking for engaging teaching materials
  • Learners of all ages interested in simplified explanations
  • Hindi/English bilingual users

Project Structure

The project is organized into frontend and backend components:

  • Frontend: Built with React and TypeScript, featuring a clean, responsive UI, accessibility controls, and dark/light mode support.
  • Backend: Utilizes Supabase Edge Functions for serverless APIs, handling story generation and audio narration.
  • Integrations: Connects with AI services for story generation and text-to-speech.

Key Features

  • AI-powered story generation based on user topics
  • Interactive and accessible user interface
  • Audio narration with character-specific voices
  • Local storage and management of story history
  • Real-time feedback and session analytics

How It Works

  1. Users enter a topic they want to learn about.
  2. The system analyzes the topic and generates a Hinglish story with a unique character and educational content.
  3. Users can listen to the story via audio narration.
  4. Generated stories are saved locally for future reference and can be marked as favorites.

Technology Stack

  • Frontend: React, TypeScript, Tailwind CSS, Shadcn UI
  • Backend: Supabase Edge Functions (TypeScript)
  • AI Services:
    • Gemini API for topic analysis and validation
    • ElevenLabs API for text-to-speech
    • Mixtral AI model for story generation

Future Enhancements

  • User authentication and cloud storage
  • Support for multiple languages and interactive story elements
  • Educational features like quizzes and progress tracking
  • Social sharing and collaborative learning tools
  • Personalized learning paths based on user preferences

Credits

Created by Arshad Ali Bhorania


Last updated: May 2, 2025

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages