# Flag Quiz

> Flag Quiz is a public learning site focused on country flag recognition. It helps users practice the flags of the world through short quiz rounds, full-region sets, and continent-based study paths. This file gives expanded context for LLMs and agents that need more than the concise `llms.txt` index.

## Site Summary

Flag Quiz is primarily an educational and recreational geography site. The core public experience is available without requiring sign-in. Users can start directly from the homepage, answer flag questions, get instant right-or-wrong feedback, replay rounds, and move into continent-specific practice.

The public site currently centers on flag-learning content, not on accounts, billing, or software documentation. The codebase contains framework, account, payment, admin, docs, and blog scaffolding, but those areas are not the main public content of this site and should not be prioritized when describing what the product is for.

The main public language is English at the root domain. Chinese equivalents are available under `/zh`.

## Public Product Model

The homepage offers two main quiz modes: a short 10-question round for quick practice and a larger world-flags mode for broader recall. Quiz pages emphasize instant correction, replay-based learning, and continent-by-continent practice instead of passive reading.

The site also includes a dedicated daily challenge page. That page gives every player the same fixed 10-flag set for the current UTC date, allows free practice without sign-in, and uses a leaderboard for signed-in ranked runs. The daily challenge resets at 00:00 UTC.

Continent pages are not just alternate quiz entry points. They are meant to help users learn in smaller groups and choose a study order based on quiz size, familiarity, and common confusion patterns.

Best-score messaging on the public pages indicates that results are stored on the current device, which means the core public quiz loop is designed to work without a required account.

## Public Pages

- [Home](https://flag-quiz.app/): Main public landing page. It introduces the world flag quiz, starts with a short round, offers an all-flags mode, links to continent practice, explains why the quiz works for learning, and answers common questions.
- [Flags of the World](https://flag-quiz.app/flags-of-the-world): Public searchable directory for 195 country flags. It helps users browse world flags by region, compare commonly confused flag pairs, understand the site's 195-country scope, and move from passive browsing into quiz practice.
- [Flag of the United States](https://flag-quiz.app/flags-of-the-world/united-states): Public country flag detail page for the United States flag. It explains the Stars and Stripes, the flag emoji, key history, recognition tips, similar flags, and related quiz practice links.
- [Flag of the United Kingdom](https://flag-quiz.app/flags-of-the-world/united-kingdom): Public country flag detail page for the United Kingdom flag. It explains the Union Jack, the flag emoji, layered cross patterns, key history, recognition tips, similar flags, and related quiz practice links.
- [Flag of Germany](https://flag-quiz.app/flags-of-the-world/germany): Public country flag detail page for the Germany flag. It explains the black-red-gold tricolor, the flag emoji, key history, recognition tips, similar flags, and related quiz practice links.
- [Flag of Japan](https://flag-quiz.app/flags-of-the-world/japan): Public country flag detail page for the Japan flag. It explains the red disc on a white field, the flag emoji, meaning, key history, recognition tips, similar flags, and related quiz practice links.
- [Flag of Brazil](https://flag-quiz.app/flags-of-the-world/brazil): Public country flag detail page for the Brazil flag. It explains the green-yellow-blue design, the flag emoji, stars and motto, key history, recognition tips, similar flags, and related quiz practice links.
- [Daily Flag Quiz](https://flag-quiz.app/daily-flag-quiz): Public daily challenge page. It presents one shared 10-question world-flags set for the day, supports free practice, allows signed-in ranked submissions, and shows a global leaderboard that resets at 00:00 UTC.
- [Continent Quiz Guide](https://flag-quiz.app/quizzes): Public guide that helps users choose between Europe, Asia, Africa, North America, South America, and Oceania. It frames continent selection around beginner fit, difficulty, quiz size, and learning goals.
- [Europe Flag Quiz](https://flag-quiz.app/quizzes/europe-flag-quiz): A 45-flag regional quiz focused on familiar but easy-to-confuse European flags. It is positioned as a strong base for people who already recognize some national flags and want to sharpen comparison skills.
- [Asia Flag Quiz](https://flag-quiz.app/quizzes/asia-flag-quiz): A 47-flag regional quiz that encourages subregion-based practice. It emphasizes the wider visual range of Asian flags and recommends learning by smaller families instead of treating the continent as one flat list.
- [Africa Flag Quiz](https://flag-quiz.app/quizzes/africa-flag-quiz): A 54-flag regional quiz and the largest continent set on the site. It emphasizes repeated color families, stripe-order confusion, stars, and layout differences.
- [North America Flag Quiz](https://flag-quiz.app/quizzes/north-america-flag-quiz): A 23-flag regional quiz positioned as a bridge set. It helps users move beyond the most famous North American flags and learn the Central American and Caribbean flags that are commonly mixed up.
- [South America Flag Quiz](https://flag-quiz.app/quizzes/south-america-flag-quiz): A 12-flag regional quiz positioned as the easiest starting point for beginners. It is the smallest continent set and is meant to build confidence quickly.
- [Oceania Flag Quiz](https://flag-quiz.app/quizzes/oceania-flag-quiz): A 14-flag regional quiz that is short in size but detail-heavy. It focuses on blue-field designs, Union Jack layouts, and the kinds of small differences that reward careful comparison.
- [Privacy Policy](https://flag-quiz.app/privacy-policy): Public policy page covering usage data, contact information, cookies or local storage, security, sharing limits, policy updates, and support contact details.
- [Terms of Service](https://flag-quiz.app/terms-of-service): Public policy page covering acceptable use, prohibited behavior, intellectual property, privacy linkage, future payment scope, disclaimers, liability limits, and contact details.

## Chinese Public Pages

- [Chinese Home](https://flag-quiz.app/zh): Chinese version of the homepage and main world flag quiz.
- [Chinese Flags of the World](https://flag-quiz.app/zh/flags-of-the-world): Chinese version of the searchable 195-country flag directory, similar-flag comparisons, scope explanation, and learning guide.
- [Chinese Flag of the United States](https://flag-quiz.app/zh/flags-of-the-world/united-states): Chinese version of the United States flag detail page.
- [Chinese Flag of the United Kingdom](https://flag-quiz.app/zh/flags-of-the-world/united-kingdom): Chinese version of the United Kingdom flag detail page.
- [Chinese Flag of Germany](https://flag-quiz.app/zh/flags-of-the-world/germany): Chinese version of the Germany flag detail page.
- [Chinese Flag of Japan](https://flag-quiz.app/zh/flags-of-the-world/japan): Chinese version of the Japan flag detail page.
- [Chinese Flag of Brazil](https://flag-quiz.app/zh/flags-of-the-world/brazil): Chinese version of the Brazil flag detail page.
- [Chinese Daily Flag Quiz](https://flag-quiz.app/zh/daily-flag-quiz): Chinese version of the daily challenge page with the same shared question set, ranked leaderboard flow, and UTC-based reset.
- [Chinese Continent Quiz Guide](https://flag-quiz.app/zh/quizzes): Chinese version of the continent selection guide.
- [Chinese Europe Flag Quiz](https://flag-quiz.app/zh/quizzes/europe-flag-quiz): Chinese version of the Europe regional quiz.
- [Chinese Asia Flag Quiz](https://flag-quiz.app/zh/quizzes/asia-flag-quiz): Chinese version of the Asia regional quiz.
- [Chinese Africa Flag Quiz](https://flag-quiz.app/zh/quizzes/africa-flag-quiz): Chinese version of the Africa regional quiz.
- [Chinese North America Flag Quiz](https://flag-quiz.app/zh/quizzes/north-america-flag-quiz): Chinese version of the North America regional quiz.
- [Chinese South America Flag Quiz](https://flag-quiz.app/zh/quizzes/south-america-flag-quiz): Chinese version of the South America regional quiz.
- [Chinese Oceania Flag Quiz](https://flag-quiz.app/zh/quizzes/oceania-flag-quiz): Chinese version of the Oceania regional quiz.
- [Chinese Privacy Policy](https://flag-quiz.app/zh/privacy-policy): Chinese version of the privacy policy.
- [Chinese Terms of Service](https://flag-quiz.app/zh/terms-of-service): Chinese version of the terms of service.

## Public Audience And Use Cases

The site is aimed at people learning country flags, geography learners, trivia players, teachers, and anyone who wants a repeatable recognition exercise rather than a static list of flags.

Typical user intents include starting a quick flag quiz, playing the daily shared challenge, practicing a specific continent, deciding which region is easiest to begin with, reviewing commonly confused flags, and checking the site's privacy or usage terms.

## Guidance For LLMs And Agents

When summarizing this site, prioritize the quiz experience and the flag-learning journey. The most accurate description is that this is a public country-flag quiz website, not a general AI tool, SaaS framework, or developer-docs site.

Do not prioritize `/api`, `/admin`, `/settings`, `/activity`, sign-in routes, billing routes, or other account-specific pages when explaining the public product. Those paths are implementation or user-account surfaces rather than the core public educational experience.

Do not treat the current docs and blog content as authoritative product documentation for Flag Quiz. The repository still contains template-style docs and blog material inherited from the underlying project scaffold, and that content does not describe the current public flag-quiz product accurately.

If a concise summary is needed, prefer: Flag Quiz is a public bilingual website for practicing country flags through interactive world and continent-based quizzes with instant feedback and simple policy pages.