Skip to content

Submit Your Story 📝✨#

We'd love to feature your FableFlow creation in our story library! Sharing your work helps inspire other creators and builds our growing community of storytellers.

Stories are currently from the FableFlow author, but we're excited to welcome contributions from other creators!

📚 Submission Guidelines#

What We're Looking For#

🌟 High-Quality Stories

  • Complete narratives with clear beginning, middle, and end
  • Engaging characters and compelling plots
  • Multimedia elements (images, audio, optional video)
  • Age-appropriate content for specified audience

🎓 Educational Value (Optional)

  • Stories that teach or inspire learning
  • Accurate information and research
  • Clear learning objectives when applicable
  • Discussion questions or extension activities

🎨 Technical Requirements

  • All output files generated by FableFlow
  • Proper formatting as per the book structure
  • Multiple formats (PDF, EPUB, HTML, etc.)

Submission Requirements#

📝 Story Materials

  • Complete story files (all formats)
  • High-resolution cover image
  • Author bio and photo (optional)
  • Story summary and description

📋 Educational Information

  • Target age range
  • Learning objectives
  • Subject areas covered
  • Discussion questions

⚖️ Legal Requirements

  • Original content or proper permissions
  • Rights to all images, music, and audio
  • Agreement to feature in FableFlow library
  • Attribution preferences

🚀 Submission Process#

1. Prepare Your Materials#

After running FableFlow, you'll have all the generated content in your output directory. Your story folder should contain all the files generated by FableFlow, similar to this structure:

Story Package Structure: 

your_story_name/
├── draft_story.txt          # Your original story draft
├── final_story.txt          # Final edited version
├── book.md                  # Markdown book version
├── book.pdf                 # PDF version
├── book.epub                # EPUB version
├── formatted_book.html      # HTML version
├── image_0.png              # Generated illustrations
├── image_1.png
├── image_N.png
├── narration.m4a            # Audio narration (if generated)
├── music.mp3                # Background music (if generated)
├── story_video.mp4          # Video version (if generated)
└── [other FableFlow outputs]

Reference Example: See the structure in docs/books/curious_cassie/curious_cassie_beach_ride_quests/ for a complete example.

2. Quality Check#

Before submitting, ensure your story meets our quality standards:

✅ Content Quality

  • Engaging, age-appropriate narrative
  • Clear educational value
  • Accurate information and research
  • Positive, inclusive messaging

✅ Technical Quality

  • Error-free text and formatting
  • High-quality images and audio
  • Consistent visual style
  • Accessible design

✅ Educational Value

  • Clear learning objectives
  • Age-appropriate complexity
  • Discussion questions provided
  • Extension activities suggested

3. Submit Your Story via GitHub Pull Request#

Step-by-Step PR Submission:

  1. Fork the Repository
  2. Go to https://github.com/suneeta-mall/fable-flow

  3. Click "Fork" to create your own copy

  4. Add Your Story

  5. Clone your forked repository
  6. Create a new folder in docs/books/ with your story name (use lowercase and underscores, e.g., my_amazing_story)
  7. Copy all FableFlow-generated files into this folder

  8. Ensure the structure matches the example in docs/books/curious_cassie/curious_cassie_beach_ride_quests/

  9. Create a Pull Request

  10. Commit your changes
  11. Push to your fork
  12. Create a pull request to the main repository
  13. Use the PR template provided below

Alternative: Share via GitHub Discussions If you're not comfortable with PRs, you can share your story in GitHub Discussions for community feedback first.

📋 Pull Request Template#

When creating your PR, please include this information in the PR description:

# Story Submission: [Your Story Title]

## Story Information
- **Title**:
- **Author**:
- **Author GitHub**: @your-github-username
- **Target Age**:
- **Reading Time**:
- **Subjects/Themes**:

## Story Summary
[2-3 sentence description of your story]

## Files Included
- [ ] draft_story.txt
- [ ] final_story.txt
- [ ] book.md / book.pdf / book.epub
- [ ] Images (image_0.png, image_1.png, etc.)
- [ ] narration.m4a (optional)
- [ ] music.mp3 (optional)
- [ ] story_video.mp4 (optional)

## Educational Value (if applicable)
- **Learning Objectives**:
- **Key Concepts**:
- **Discussion Topics**:

## Rights & Permissions

- [ ] I own all rights to this content or have permission to share it
- [ ] I agree to share this story under the Elastic License 2.0
- [ ] All content generated by FableFlow or owned/licensed by me

## Additional Notes
[Any additional information about your story or special requirements]

## Checklist

- [ ] Story folder created in `docs/books/`
- [ ] All generated files from FableFlow included
- [ ] Story structure matches the example format
- [ ] Content is age-appropriate and high-quality

🔄 Review Process#

Your story will be reviewed by the maintainers. Once your PR is approved, it will be merged and made available in the production website.

Review Focus Areas#

  • Content Quality: Narrative coherence, age-appropriateness, and overall quality
  • Technical Compliance: Proper file structure and format as per the examples
  • Rights & Licensing: Confirmation of ownership and licensing compliance
  • Community Guidelines: Alignment with project values and standards

Timeline may vary depending on maintainer availability. Thank you for your patience and contribution!

🎯 Tips for Success#

Making Your Story Stand Out#

🎭 Compelling Characters - Create relatable, diverse protagonists - Give characters clear motivations - Show character growth and learning - Include positive role models

📚 Educational Integration - Weave learning naturally into the plot - Use accurate, age-appropriate information - Provide clear takeaway messages - Include hands-on application opportunities

🎨 Professional Presentation - Invest time in visual design - Ensure consistent style throughout - Test on multiple devices and formats - Get feedback before submitting

🌍 Inclusive Storytelling - Represent diverse characters and perspectives - Use inclusive language and imagery - Consider accessibility needs - Celebrate different ways of learning and thinking

Common Pitfalls to Avoid#

❌ Educational Overload

  • Don't sacrifice story for information
  • Avoid overly complex concepts
  • Keep the narrative engaging
  • Balance education with entertainment

❌ Technical Issues

  • Poor image quality or resolution
  • Inconsistent formatting
  • Audio sync problems
  • Accessibility barriers

❌ Content Problems

  • Inappropriate content for age group
  • Inaccurate or misleading information
  • Stereotypes or exclusive messaging
  • Overly promotional content

What You Get#

🎉 Recognition - Featured in our story library - Creator spotlight in our blog - Social media promotion - Community celebration

📊 Impact Tracking

  • Reader engagement statistics
  • Educational impact metrics
  • Community feedback and reviews
  • Usage in educational settings

🤝 Community Connection

  • Direct connection with readers
  • Educator feedback and testimonials
  • Collaboration opportunities
  • Ongoing community support

🔄 Professional Development

  • Experience with multimedia storytelling
  • Portfolio addition for educators/creators
  • Networking with like-minded creators
  • Skill development in AI-assisted creation

📞 Questions & Support#

Need Help?#

🛠️ Technical Support

  • GitHub Issues for technical problems
  • Community discussions for creation help
  • Documentation and tutorials
  • Video guides and examples

📝 Content Guidance

  • Educational standards alignment
  • Age-appropriateness questions
  • Storytelling best practices
  • Accessibility guidelines

⚖️ Legal & Rights

  • Copyright and permissions questions
  • Attribution requirements
  • Licensing information
  • Usage rights clarification

Contact Information#

🚀 Ready to Share Your Story?#

We can't wait to see what you've created! Your story could be the next adventure that sparks curiosity and inspires learning in children around the world.

Thank you for contributing to our community of curious creators and lifelong learners!