Mien Kingdom

Home Page
Title Name

Inspiration

The Iu Mien (Yao) people carry a rich cultural heritage spanning thousands of years across the
mountainous regions of Southeast Asia and China. After displacement from the Vietnam War, Mien
communities resettled across the United States, France, Canada, and beyond — but with each passing generation, the Mien language and traditions are fading. The language is now considered endangered, with fewer children growing up speaking it at home. The oral traditions, folk stories, ceremonial chants, and everyday expressions that once defined Mien identity risk being lost forever.

Mien Kingdom was inspired by the urgent need to preserve this culture before it disappears, and the belief that artificial intelligence can be a powerful equalizer for underrepresented and minority communities — providing tools that would otherwise require massive resources to build.

## What it does

Mien Kingdom is a mobile-first social community app built for the Iu Mien diaspora. It serves as a digital home where Mien people can connect, learn, create, and celebrate their heritage.

Community & Social — A unified feed aggregating content from YouTube, TikTok, Instagram, Facebook, and Twitter/X, along with a follow system, end-to-end encrypted direct messaging, and push notifications.
AI Translation & Language — Bidirectional Mien translation across 11 languages (English, Vietnamese, Mandarin, Hmong, Cantonese, Thai, Lao, Burmese, French, Pinghua, and Khmer), plus a searchable Mien dictionary and interactive grammar book.
AI Creative Tools ("Make Me Mien") — Transform photos into traditional Mien attire, generate movie poster-style images, create AI dance videos, and restore old or damaged family photos.
AI Companion ("Talk to Ong") — A real-time AI avatar companion powered by WebRTC, avatar rendering, and conversational AI for interactive cultural engagement.
Education & Games — A literature hub with Mien stories, plus Mien Wordle, Vocab Match, and Wheel of Fortune games with leaderboards and an XP/leveling system.
Food & Recipes — An AI-powered recipe generator with Mien cultural context, saved recipe collections, and community sharing.

## How we built it

Frontend: React Native with Expo 54, delivering a single codebase for iOS, Android, and Web. React Navigation handles routing, and TanStack React Query v5 manages server state.
Backend: Express 4 with TypeScript, serving 163+ API endpoints. PostgreSQL with Drizzle ORM powers 60+ database tables across users, social, messaging, media, education, AI, recipes, billing, and analytics domains.
AI Services: Google Gemini API with key rotation for translation, recipe generation, and conversational AI. A configurable multi-provider system supports OpenAI, Anthropic, Grok, and WaveSpeed for different workflows.
Real-Time Avatar: LiveKit (WebRTC) for real-time communication, Simli for avatar rendering, and Gemini for conversational intelligence — orchestrated together for the "Talk to Ong" experience.
Security: X25519 key exchange for end-to-end encrypted messaging, AES-256-GCM encryption for stored credentials, and JWT authentication with multi-provider OAuth (Google, Twitter, Instagram, TikTok, Facebook).
Infrastructure: Cloudflare R2 for image storage, Bunny.net for video streaming and CDN delivery, and Stripe + RevenueCat for subscription billing across web and mobile.

## Challenges we ran into

Language data scarcity — Mien is an endangered language with very limited digital resources. There are no large existing datasets for translation or dictionary data, so we often had to create the dataset as we built the product.
Multi-platform social aggregation — Unifying content from five different social platforms into a single cohesive feed required handling different APIs, content formats, and rate limits.
Real-time AI avatar orchestration — Coordinating LiveKit (WebRTC), Simli (avatar rendering), and Gemini (conversational AI) into a seamless real-time experience with credit-based billing was a significant technical challenge.
End-to-end encryption — Implementing X25519 key exchange for private messaging while keeping the user experience simple and intuitive across all platforms.
Cross-platform consistency — Ensuring a single React Native codebase delivers a polished experience on iOS, Android, and Web simultaneously, especially for complex features like video playback and real-time communication.

## Accomplishments that we're proud of

Built by Mien, for Mien — This is a community-driven project created by Three Tears LLC, a team of Mien people building technology for their own people.
Bidirectional Mien translation across 11 languages — One of the first digital translation tools of its kind for the Mien language.
A production-grade platform — With 60+ database tables, 163+ API endpoints, and a full admin panel, this is a comprehensive product, not just a prototype.
AI as cultural preservation — We use cutting-edge AI (image generation, translation, real-time avatar) not for novelty, but to keep an endangered culture alive and accessible.
Secure community space — End-to-end encrypted messaging with X25519 key exchange gives the community a private, safe space to communicate.
Learning through play — A full educational gaming suite (Wordle, Vocab Match, Wheel of Fortune) with XP progression makes learning the Mien language fun and engaging.

## What we learned

AI is an enabling technology for minority communities. It levels the playing field by providing tools — translation, content generation, interactive learning — that would otherwise require resources far beyond what a small community can muster.
Cultural preservation must meet people where they are — on their phones, on social media, and in games — not just in textbooks or museums.
Building for an endangered language means building the data, too. Existing digital resources are scarce, so the product and the dataset grow together.
Cross-platform mobile development has matured, but real-time features like WebRTC avatars and encrypted messaging still require careful architectural planning.
Community trust is earned through ownership. When the people building the technology are from the community it serves, adoption and engagement follow naturally.

## What's next for Mien Kingdom

Expand the Mien dictionary and translation corpus through community contributions and AI-assisted data collection.
Dynamic AI workflow configuration — The admin panel already supports configuring which AI service and model powers each feature; the next step is wiring all routes to read from this config dynamically.
More educational content — Additional stories, grammar lessons, and interactive learning modules for all ages.
Community-generated content — Enable users to contribute translations, stories, recipes, and cultural knowledge directly into the platform.
Broader language and dialect support — Deeper coverage of Mien dialects and regional variations.
Offline support — Caching key features for areas with limited internet connectivity.
Partnerships with Mien cultural organizations — Collaborating with community leaders, elders, and educators to ensure authenticity and reach.