Skip to content

JamesANZ/basic-mongolian-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation

🇲🇳 Mongolian Learning App

A comprehensive, interactive web application for learning Mongolian language basics. This is a pure client-side application that runs entirely in your browser - no server required!

✨ Features

  • 🔤 Mongolian Cyrillic Alphabet - Learn all 35 letters with pronunciation and examples
  • 🔢 Numbers 1-20 - Count in Mongolian with audio pronunciation
  • 💬 Basic Words - Essential vocabulary for everyday communication
  • ✈️ Travel Phrases - Essential phrases for travelers in Mongolia
  • 🏃 Essential Verbs - Common verbs with present, past, and future conjugations
  • 📚 Travel Vocabulary - Important words for navigating Mongolia
  • 💕 Romantic Phrases - Phrases for romantic moments
  • 🎯 Interactive Quiz - Test your knowledge with randomized questions
  • 🔊 Audio Pronunciation - Click any card to hear pronunciation using Spanish voice (optimized for Mongolian sounds)

🚀 Getting Started

Option 1: Direct Browser Opening (Recommended)

  1. Download or clone this repository
  2. Simply open public/index.html in any modern web browser
  3. Start learning Mongolian immediately!

Option 2: Local Server (Optional)

If you prefer to serve it locally:

# Using Python 3
python -m http.server 8000

# Using Python 2
python -m SimpleHTTPServer 8000

# Using Node.js (if you have it installed)
npx serve public

Then open http://localhost:8000 in your browser.

🎨 Design Features

  • Modern Glass Morphism UI - Beautiful, modern design with glass-like effects
  • Responsive Design - Works perfectly on desktop, tablet, and mobile
  • Interactive Cards - Click anywhere on a card to hear pronunciation
  • Smooth Animations - Hover effects and transitions for better UX
  • Keyboard Navigation - Use Escape key to return to alphabet section
  • Visual Feedback - Clear indicators for clickable elements

📱 Browser Compatibility

  • ✅ Chrome (recommended)
  • ✅ Firefox
  • ✅ Safari
  • ✅ Edge
  • ✅ Mobile browsers

🎯 How to Use

  1. Navigation: Click the navigation buttons to switch between sections
  2. Pronunciation: Click anywhere on any card to hear the pronunciation
  3. Quiz: Take the interactive quiz to test your knowledge
  4. Keyboard: Use the Escape key to quickly return to the alphabet section

🗣️ Audio Features

  • Spanish Voice: Uses Spanish voice synthesis for better Mongolian pronunciation
  • Fallback Support: Shows pronunciation overlay if audio isn't supported
  • Optimized Settings: Slower speech rate for better learning comprehension

📁 Project Structure

mongolian-game/
├── public/
│   ├── index.html          # Main HTML file (open this in browser)
│   ├── styles.css          # All styling and animations
│   └── script.js           # All JavaScript functionality
└── README.md               # This file

🛠️ Technology Stack

  • HTML5 - Structure and content
  • CSS3 - Styling, animations, and responsive design
  • Vanilla JavaScript - All functionality and interactivity
  • Web Speech API - Audio pronunciation
  • No Dependencies - Pure client-side, no frameworks or libraries needed

🎓 Learning Content

The app includes comprehensive Mongolian language content:

  • 35 Cyrillic letters with pronunciation guides
  • Numbers 1-20 with Mongolian and English
  • Essential travel phrases for visitors
  • Common verbs with full conjugations
  • Travel vocabulary for practical use
  • Romantic phrases for personal communication
  • Interactive quiz with questions from all sections

🌟 Why This Approach?

This app was designed as a pure client-side application for several benefits:

  • No Server Required - Works immediately without setup
  • Offline Capable - All data is embedded in the HTML
  • Fast Loading - No network requests for content
  • Easy Sharing - Just send the HTML file
  • Simple Deployment - Upload to any static hosting service
  • No Dependencies - No Node.js, npm, or other tools needed

🚀 Deployment

You can easily deploy this app to any static hosting service:

  • GitHub Pages - Free hosting for public repositories
  • Netlify - Drag and drop deployment
  • Vercel - Simple deployment from Git
  • Any Web Server - Just upload the public folder

🤝 Contributing

Feel free to contribute by:

  • Adding more Mongolian content
  • Improving the UI/UX
  • Adding new features
  • Fixing bugs
  • Translating to other languages

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

  • Mongolian language experts for pronunciation guidance
  • Web Speech API for audio functionality
  • Modern CSS techniques for beautiful design

Start your Mongolian language journey today! 🇲🇳✨

Releases

No releases published

Packages

No packages published