Help & Support

Ukraine Truth turns war reporting into structured, sourced events you can explore and verify. For what the project is and how we rate confidence, see About and Methodology. This page is a quick guide to using the site and the app, and a place to report problems or suggest features.

Using the website

Dashboard

The home page is a live overview: total events, sources, and entities tracked, with charts that break activity down by type, region, and time. It is the fastest way to see the current shape of the war coverage.

Explorer

The Explorer is the main research tool. Filter events by type (attack, defense, statement, and more), by source, by region (oblast) and city, by date range, by named entities, and by confidence. Filtering runs in your browser, so it is fast and works as you type. You can save filter sets and export the results.

Timeline

The Timeline shows events in chronological order, grouped by day and month. Use the year and month controls to jump to a period.

Sources

The Sources directory rates each outlet's reliability using a documented scoring model. Primary sources (boots-on-the-ground journalists and analysts) are the truth signal; other outlets are weighed against them.

Event pages

Open any event to see its summary, the individual claims, which sources made them, whether they are corroborated, and the resulting confidence rating. Every rating is explainable, and we show our work.

Search

Use the search icon in the top bar to search across events, sources, and entities and jump straight to a result.

Adding a source

On an event page you can submit an additional news source that corroborates or contradicts the event. We review every submission. This is how the public helps strengthen (or challenge) the record.

Using the iOS app

First launch

On first launch the app downloads the full event database so the data works offline. This is a sizable download, so use Wi-Fi the first time. After that, the app reads everything locally and only fetches updates when the published data changes.

The tabs

• Dashboard — the same at-a-glance metrics and charts as the website home page.
• Explorer — filter and search every event offline; share results as CSV.
• Timeline — browse chronologically; tap a month in the density chart to jump to it.
• Sources — the source reliability directory.
• About — project info, privacy policy, contact form, and data management.

Keeping data current

The app refreshes automatically in the background when the data changes, but to keep cellular data use down, automatic refreshes happen on Wi-Fi. To update on demand, pull down to refresh on the Dashboard. Links to an event (for example, tapping a ukrainetruth.com/event/… link) open that event directly in the app.

Managing storage

Historical years are kept on device for offline use. In About → Data Management you can delete downloaded historical data to reclaim space and return to the latest core dataset; it re-downloads on demand when you browse those years again.

Troubleshooting

• Data looks out of date: pull to refresh on the Dashboard while on Wi-Fi.
• Setup or refresh keeps failing: make sure you have a stable connection and some free storage, then use Reset DB & Retry on the setup screen.
• "Update required" message: the published data uses a newer format than your installed app. Update the app from the App Store.
• Run a self-check: About → Run Production Checks verifies the app can reach the live data and reports any problems.

Privacy

We don't track you. See the Privacy Policy for what the site and app do and don't collect.