Inspiration
I’ve always been fascinated by words and their hidden stories. Most dictionary apps show only definitions, leaving out etymology, phonetics, visuals, and fun facts. I wanted to create a Telegram based app that turns word exploration into a playful, educational experience, accessible without any external sign up, since it work when user is already login into telegram and bot will automatically fetch user login details.
What it does
Ety.ai is a full-stack, serverless, AI-powered Telegram mini-app that lets users Search a word and instantly get etymology, roots, phonetics, and fun facts See AI-generated visuals illustrating the word Listen to voice narration via AI TTS Earn XP, badges, and levels through searches, deep dives, and shares Share rich Word Cards inline to any chat Automatically sync with dark/light mode of the user’s device It gamifies learning and encourages daily engagement through streaks and leaderboards.
How we built it
Frontend: React + TypeScript + Tailwind CSS, fully responsive and theme-aware Backend: Node.js serverless functions on Vercel for AI requests, TTS, and caching Database: MongoDB Atlas to store user history, XP, badges, and leaderboards
AI Integration: Google Gemini for summaries and TTS Pollinations AI for word illustrations
Caching: Hybrid L1 (localStorage) + L2 (Server + MongoDB) for low latency
Gamification: XP, levels, badges, and streaks calculated and stored per user Example XP progression formula: XPnext_level=⌈100⋅(1.5)level−1⌉
Challenges we ran into
API Rate Limits: Free-tier AI APIs caused 429 errors; solved with sequential key rotation and mock fallbacks Telegram Integration: Implementing inline sharing, Main/Back buttons, and theme syncing required careful state management Real-Time Audio: Converting PCM → WAV for smooth playback on mobile devices was tricky Cache Design: Ensuring instant results without repeated API calls while keeping UX smooth
Accomplishments that we're proud of
Fully functional Telegram mini-app with AI-powered discovery Gamification engine with XP, levels, badges, and leaderboard Smooth real-time voice narration and AI visuals Automatic dark/light theme toggle synced to device Seamless inline sharing with rich Word Cards
What we learned
Full-stack serverless architecture and state management AI integration for text, audio, and image generation Designing gamification and engagement loops Handling API limits and building resilient systems
What's next for ety.ai-telegram-mini-app
Add multilingual support for more users Enhance visual generation with more context-aware AI illustrations Introduce personalized learning paths based on user interests Expand social features, including group competitions and challenges
