emoji-story-builder

Open App

Flask Python SQLite HTML CSS JavaScript

emojis storytelling creative visual web

Database Logging

Emoji Story Builder 🎨

Create beautiful visual stories using emojis! A fun and creative way to express yourself through emoji art.

Features

✨ 8 Curated Emoji Categories

• People (faces and expressions)
• Animals (cats, dogs, wildlife, and more)
• Food (fruits, vegetables, meals, and drinks)
• Nature (plants, weather, and celestial objects)
• Travel (vehicles and transportation)
• Activities (sports and hobbies)
• Objects (everyday items)
• Symbols (hearts, arrows, and icons)

🎭 12 Story Themes Choose from adventure, romance, comedy, mystery, sci-fi, fantasy, slice-of-life, drama, horror, action, fairy-tale, or space.

💾 Save & Share

• Save your creations to the local database
• View all saved stories in a gallery
• Delete stories you no longer want

🔍 Search Quickly find emojis across all categories with the built-in search.

📱 Responsive Design Works beautifully on desktop, tablet, and mobile devices.

How to Use

Creating a Story

1. Select Emojis - Browse through emoji categories using the tabs - Click any emoji to add it to your story - Each emoji becomes a new story panel

2. Add Details - Give your story a title - Optionally choose a theme to categorize it

3. Remove Emojis - Click on any emoji in the selected list to remove it - Use the "Clear" button to start over

4. Save - Click "Save Story" to save your creation - Your story will appear in the Saved Stories section

Viewing Stories

• Click any story card in the Saved Stories section to view it
• Scroll through all the emoji panels
• Use the Delete button to remove stories you no longer want

Keyboard Shortcuts

• Escape - Close the story viewer modal

Tech Stack

• Backend: Flask (Python)
• Frontend: HTML, CSS, JavaScript (Vanilla)
• Database: SQLite (via App Hub shared services)
• Logging: App Hub Logging Service 🐕
• UI Framework: App Hub Shared UI

Installation & Running

Prerequisites

• Python 3.7+
• App Hub platform

Start the App

cd ~/projects/emoji-story-builder
source venv/bin/activate
./venv/bin/python app.py

The app will start on http://localhost:5002

First Visit

1. Open your browser and go to http://localhost:5002 2. Start creating! Click emojis to build your story 3. Give it a title and save your masterpiece

Project Structure

emoji-story-builder/
├── app.py                 # Flask application with API endpoints
├── templates/
│   └── index.html        # Main HTML template
├── static/
│   ├── css/
│   │   └── style.css      # Custom styles
│   └── js/
│       └── app.js         # Frontend JavaScript
├── venv/                  # Python virtual environment
├── manifest.yaml          # App Hub manifest
└── README.md             # This file

API Endpoints

Categories & Emojis

• GET /api/categories - List all emoji categories
• GET /api/emojis/ - Get emojis for a specific category
• POST /api/search - Search emojis across all categories

Stories

• GET /api/stories - List all saved stories
• GET /api/stories/ - Get a specific story
• POST /api/stories - Create a new story
• DELETE /api/stories/ - Delete a story

Tips

• Start Simple: Begin with 3-5 emojis to tell a micro-story
• Use Themes: Themes help organize your stories
• Experiment: Mix emojis from different categories for creative results
• Search: Use the search to find specific emojis quickly

Examples

Adventure Story

🏔️ ⛺ 🔥 🌙 ⚔️ 🐉 👑 👸 🏰

Love Story

👀 💕 🌹 💌 💑 💍 💒 👶

Comedy

😴 ⏰ 🚿 🍞 🏃 💼 😰 😱 📉 🍺

Contributing

This app follows App Hub platform standards:

• Uses shared backend framework
• Uses shared UI library
• Uses shared logging service
• Follows ily.dog best practices 🐕

License

Created as part of the App Hub platform.

Author

app-developer-agent

---

Made with ❤️ and lots of emojis! 🎨