Skip to content

icepick4/capitalympics

Repository files navigation

Capitalympics Website

Capitalympics Logo

Learn flags and capitals of the world !

forthebadge forthebadge forthebadge

🌍 Capitalympics is a web application that helps you learn the flags and capitals of countries around the world. It provides a filtered learning experience by allowing you to focus on specific regions of the world. You can track your progress with individual scores for each country as well as an overall score. The application also allows you to view your statistics on your profile and sort and filter them by category.

📊 Get ready to challenge yourself, improve your knowledge, and become a global expert!

Getting Started

  1. Visit the Capitalympics website.
  2. Sign up for an account to unlock the learning features.
    • Go to this page and create your account.
    • You can edit it at any time on this page.
  3. Explore the vast collection of country information, which is accessible without an account.
  4. Start your learning journey by selecting a mode (flag or capital) and a region.
  5. Track your progress and delve into statistics on your profile page.

Features

  • Progression statistics

  • Store favorite session setup

  • Notifications on level up and level down

  • Learn flags and capitals of countries worldwide

  • Learn location of countries worldwide

  • Filter learning by regions of the world

  • Track scores for each country and overall progress

  • View comprehensive statistics on your profile

  • Sort and filter statistics by category

  • Create an account to unlock enhanced features

  • Quizzes

    • Create your own quizzes and share them
    • Play quizzes of the community and get ranked
    • Quizzes statistics
  • Friend system

  • CI/CD

  • Accessible country information, including:

    • 🌐 Name
    • 🏛️ Official name
    • 🌆 Capital
    • 🌍 Region
    • 🔍 Subregion
    • 👥 Population
    • 🗺️ Google Maps link
    • 🚩 Flag
    • 🌍 Alpha-3 code
    • 💰 Currencies

🌐 Capitalympics is fully translated into multiple languages (English, French, Spanish and Italiano).
If your preferred language is not supported, please open an issue on the repository to request a new language.

Technologies Used

🚀 The front is built with Vue.js 3, Vite, Tailwind CSS, and TypeScript.

🚀 The back is built with Node.js, Express and MySQL.

Take a look at the API used by Capitalympics : Capitalympics API.

The learning concept

EN

The flags and capitals learning app is based on a specific concept inspired by Anki. A flag or the name of a country is displayed, and the user must decide whether they know it or not, in their own conscience. Then, the answer is revealed, and the user can choose from three difficulty levels: easy, medium, or difficult. Depending on their choice, the country or capital will be presented more or less frequently in the future, based on the user's knowledge. The goal is to provide personalized learning based on user confidence. If the user plays correctly, the algorithm will select countries or capitals optimized for learning. Enjoy this unique learning experience!

FR

L'application d'apprentissage des drapeaux et des capitales repose sur un concept particulier inspiré de l'application Anki. Un drapeau ou le nom d'un pays est affiché, et l'utilisateur doit décider s'il le connaît ou non, en son âme et conscience. Ensuite, la réponse est révélée et l'utilisateur a le choix entre trois niveaux de difficulté : facile, moyen ou difficile. Selon le choix effectué, le pays ou la capitale sera présenté plus ou moins fréquemment par la suite, en fonction de la connaissance de l'utilisateur. L'objectif est d'offrir un apprentissage personnalisé, basé sur la confiance de l'utilisateur. Si l'utilisateur joue correctement, l'algorithme sélectionnera des pays ou des capitales optimisés pour l'apprentissage. Profitez de cette expérience d'apprentissage unique !

Screenshots

Home

image

Statistics

image

Country Information

Screenshot_1

License

📝 This project is licensed under the MIT license. See the LICENSE file for more details.

Author

This project was created by icepick4. If you have any questions or suggestions, feel free to reach out to me.

Contributing

🤝 Contributions are always welcome! Here are some ways you can contribute:

  • Report bugs by creating an issue.
  • Submit pull requests to fix bugs or add new features.
  • Improve documentation.

Thanks for contributing!