Building a free Iran travel app with AI: the Koja Barim story

Planning a weekend trip but unsure which province is at its best right now, and with no internet on the road?

Koja Barim is a free, mostly offline Android app for travelling in Iran, built with AI help. AI helped write the code, draft the data and run automated tests, but the goal, safety and fact-checking stayed with a human. The result covers 31 provinces and 189 places, a one-page trip plan and safety notes for families.

By Saman Ghahreman · Published: · 7 min read

Case studies and build experience

Building a free Iran travel app with AI: the Koja Barim story

A family wants to travel this weekend. They do not know which province is in its best season now, they will have no internet on the road, and they worry about the children’s safety. Koja Barim was built for exactly that: a free Android app that mostly works offline. This article explains where AI helped, where it was wrong and how those mistakes were found.

What was the problem and what were the constraints?

The goal fit in one sentence: any family or first-time backpacker should know within ten seconds where to go and how to go safely. Four constraints guided the work.

  • Offline: province, food, festival and safety information is inside the app; only live weather, small maps and exact driving routes need the internet.
  • Free: no subscriptions, ads or trackers, for good.
  • Light: version 1.0.0 is about 1.3 MB and runs on ordinary phones.
  • Non-judgemental: safety notes are written in a friendly tone with their reasons, not as orders.

What did we hand to AI and what did we keep?

AI brings speed, but telling right from wrong stays with a person. The table shows the real split of work on this project.

TaskAIHuman
Writing the appFull app code in Kotlin and Jetpack ComposeDecisions on structure, simplicity and menus
Province and food dataDrafting descriptions and searching sourcesSpotting irrelevant descriptions and asking for fact-checks
Fact-checkingAutomatic comparison of coordinates and dates with sourcesChoosing trustworthy sources and removing doubtful entries
TestingAutomated tap-by-tap tests on a phoneReal use and reporting what did not work
Tone and safetyRewriting the textDecision: safety first, without judging people
How Koja Barim was built
  1. Define the problem

    One sentence plus four constraints.

  2. First version

    Code and draft data with AI help.

  3. Fact-check

    Compare coordinates, dates and listing years with sources.

  4. Real-phone testing

    Tap by tap, on a real phone.

  5. Simplify

    Three tabs, “My trip” and a non-judgemental tone.

How was the data fact-checked?

The first draft of the place descriptions looked right, but the project owner noticed many had little to do with the actual place. So everything was rewritten and each place was compared with its coordinates on Wikipedia. About 25 coordinates were corrected, and several wrong places, or places in the wrong province, were removed.

The UNESCO listing years of festivals and rituals came from UNESCO’s own official list, and several years in the draft were wrong. The dates of Mehregan, Qalishuyan and the Qamsar rosewater harvest were also checked against news and travel sources. The lesson: do not assume fluent AI text is correct.

How did we make sunrise and sunset accurate?

The first simple formula was up to two minutes off for dawn and dusk. We replaced it with the full NOAA solar-calculator method and compared the result for eight coastal towns with the Astral astronomy library. The difference was under one minute everywhere. One online service differed from both by one to two minutes, so do not trust a single source.

What did testing on a real phone find?

A test script tapped through all 31 provinces, every filter, every tool and voice recording on a Samsung phone. About 15 bugs were found and fixed; a few examples:

  • North Khorasan was missing entirely; we had 30 provinces, not 31.
  • The month “Dey” was also found inside the words “Ordibehesht” and “Farvardin”, so the where-to-go-now suggestion came out wrong.
  • The keyboard opened by itself on launch, and after typing the back button had to be pressed twice.
  • Returning from a province or tool made the list jump to the top, and some button labels broke mid-word.

Why safety first, and why a non-judgemental tone?

The aim was for families to trust the app easily. It has 37 plain safety tips, such as swimming only where lifeguards are present, not camping in dry riverbeds, and never running a heater inside a tent because of carbon monoxide. Each province has its own tips, and the app warns when the live weather shows thunderstorms or extreme heat.

Tone mattered too. “Never climb alone” became “climbing with others is safer; if you are new, join a club or a local guide”. People respond better to reasons than to blame.

Where should you not rely on this app alone?

  • Visiting hours, prices, and camping or fishing permits: check with official bodies.
  • Accuracy of descriptions: no tourism expert has reviewed the data yet.
  • Train, bus and flight times: estimates, not official timetables.
  • Emergencies in Iran: ambulance 115, police 110 and Red Crescent 112.

What did we learn about building apps with AI?

  1. Write the problem in one sentence with its constraints, then bring in the AI.
  2. Do not assume fluent text is correct; check numbers, dates and places against a source.
  3. For sensitive calculations, compare two independent methods.
  4. Test tap by tap on a real phone; most bugs were found there.
  5. Say where you used AI. Google’s guidance also recommends transparency about AI use.

Where can I get the app?

Koja Barim is free and downloads directly from the Koja Barim page; its privacy policy is there too. Another example of the same approach is building an offline plant-safety app with AI. If you are curious how one person built several offline Persian apps, read the case study of offline Persian apps.

Frequently asked questions

What exactly did AI do in building Koja Barim?

It wrote the app code, the draft data and the test scripts, and automatically compared coordinates and dates with sources. The goal, core decisions, spotting mistakes and the release stayed with a human.

How reliable is Koja Barim’s information?

Coordinates were compared with Wikipedia and UNESCO listing years with UNESCO’s official site, and doubtful entries were removed. A tourism expert has not reviewed it yet, so check permits and visiting hours with official bodies.

Does Koja Barim work offline?

Mostly yes: provinces, food, festivals, safety, sunrise and sunset, packing and the compass work offline. Only live weather, small maps and exact driving routes need the internet.

Why is Koja Barim free?

It is a public-good project for the safety and comfort of families and backpackers. It has no subscriptions, ads or data sales, and its code is open under the MIT licence.

Sources

Tags: building apps with AI · Iran travel app · offline travel guide · family travel safety · free Android app

Get advice on Android App Development

One short consultation is enough to clarify the path, timeline and rough cost of your project.

My promise
If you have a problem you think AI might solve, write to me. I’ll tell you honestly whether it will; sometimes the answer is no, and hearing that early is cheaper.
Book a consultation