poem-pupper

Open App

Flask Python SQLite HTML/CSS/JavaScript

poetry generator creative fun dogs

Path_resolver Logger Database

Poem Pupper 🐕✨📜

A whimsical poem generator that crafts verses with love and tail wags!

What It Does

Poem Pupper generates unique poems across 6 themes and 5 poem types:

🎨 Themes

• 🐕 Dogs — Puppers, zoomies, belly rubs, and good boys
• 🌿 Nature — Mountains, rivers, forests, and meadows
• 💕 Love — Hearts, embrace, tenderness, and devotion
• 🌊 Ocean — Waves, tides, shores, and the deep blue
• ⭐ Stars — Galaxies, moons, nebulas, and cosmic wonder
• ☕ Coffee — Espresso, steam, beans, and morning rituals

📝 Poem Types

• 🎋 Haiku — Traditional 5-7-5 syllable Japanese poetry
• 📝 Quatrain — Four-line verse with AABB rhyme scheme
• 🌊 Free Verse — Modern poetry without fixed structure
• 🎪 Limerick — Playful five-line poem with AABBA rhyme
• 👯 Couplet — Two elegant rhyming lines

Features

• 🐾 Random Generation — Pick a theme and type, or let fate decide!
• 💾 Save Favorites — Build a gallery of your best poems
• 🦴 Bone Rating — Rate poems from 1-5 bones
• ⭐ Favorites — Star your most beloved verses
• 📋 Copy to Clipboard — Share poems anywhere
• 📊 Statistics — Track your brewing habits
• 🎨 Beautiful UI — Serif typography worthy of poetry

How to Use

Running the App

cd ~/ily.dog/apps/poem-pupper
python app.py

The app will start on port 5070 (or the PORT env var).

Web Interface

1. Choose your theme — Dogs? Nature? Coffee? Pick one or go random! 2. Pick a poem type — Haiku for brevity, free verse for depth 3. Click "Brew a Poem!" — Watch the magic happen ✨ 4. Save your favorites — Build your poetry gallery 5. Rate with bones — 🦴🦴🦴🦴🦴 6. Check your stats — See your brewing patterns

Keyboard Shortcuts

• Ctrl+Enter / Cmd+Enter — Generate a new poem

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /api/generate | POST | Generate a poem ({theme, type}) | | /api/save | POST | Save a poem to gallery | | /api/poems | GET | Get all saved poems | | /api/poems//favorite | POST | Toggle favorite | | /api/poems//rate | POST | Rate a poem (1-5) | | /api/poems/ | DELETE | Delete a poem | | /api/stats | GET | Get generation statistics | | /api/themes | GET | List available themes and types |

The Magic 🪄

Poem Pupper uses curated word banks organized by theme, with carefully crafted templates for each poem type. The templates ensure:

• Proper syllable patterns for haiku
• Correct rhyme schemes for quatrains and limericks
• Evocative imagery for free verse
• Elegance in every couplet

Each poem is a unique combination — even the same theme and type will produce different results every time! 🐕

Tech Stack

• Backend: Flask + AppHubApp pattern
• Database: SQLite via shared DatabaseManager
• Frontend: Vanilla HTML/CSS/JavaScript with apphub.css/js
• Services: Path Resolver, Logger, Database

Whimsy Level

🐕✨✨✨✨ — Maximum! Poems about puppers, bones for ratings, and tail-wagging delight!

---

Brewed with love by the App Brewer Agent 🧪🐕