Walking a city together
A challenge lets a group of friends complete a city as a team. Everyone keeps walking as usual, and all of your streets add up to one shared map. Your own map, walks, and progress stay exactly as they were. Challenges work between Android and iPhone.
Start a challenge
- 1 Open Settings › Challenges and tap Start a challenge.
- 2 Pick an area: a whole city, or one area of a city that is split into areas. It has to be downloaded on your phone.
- 3 Choose what counts (see below), name the challenge, and pick the name your team will see for you. A nickname is fine.
- 4 Share the invite link or QR code with the people you want in the team.
Join a challenge
Tap the invite link on your phone. If CityWalker is installed, it opens the invite. If not, the link opens a page on citywalker.app that shows how to install it; tap the link again once the app is installed. You can also paste a link: open Settings › Challenges and tap Join with a link.
Pick the name your team will see, and download the challenge's city if you don't have it yet. Streets you walked there before joining count too, unless the challenge's rules leave them out.
What counts
The person who starts a challenge decides this, and it can't be changed later:
- All walks so far, or only walks from a date on. A walk counts when it starts on or after that day.
- Only walks recorded in CityWalker: when this is on, walks imported from GPX files don't count.
Streets you marked as walked by hand count, but the team can see that they were marked: they show dashed on the team map, and the challenge shows how much of each walker's streets, and of the team's, were marked by hand.
Reading the challenge screen
- Team %: how much of the area the team has walked together. Each street counts once, however many of you walked it.
- Who claimed what: the first person to walk a street claims it. The app only shares the day of a walk, so when two of you first walked a street on the same day, it goes to whoever joined the challenge first. Each walker has a colour, and the team map colours every street by who claimed it. Everyone's claimed share adds up to the team total.
- The team map: tap it to open it full screen. Grey streets are not walked yet.
Invites, leaving, and deleting
- Invite links stop working after 14 days, or sooner if the person who made the link leaves the challenge. Anyone with a working link can join, so share it only with people you want in the team. Invite friends on the challenge screen always gives you a link that still works, and anyone in the team can use it.
- A challenge holds up to 5 walkers, including the leader. When someone leaves, their place opens up for someone new. Walking together? One phone recording the walk is enough for the team map.
- You can host one challenge and be in one other challenge at a time.
- Leave challenge takes you out, and the streets you shared, and the invite links you made, are removed from the team. You can rejoin with any link that still works. You then count as joining last, so streets walked on the same day go to the others.
- Delete challenge (leader only) ends it for everyone and removes everything it uploaded from the server. Each walker keeps their own walks and progress.
- Delete All Data in Settings also deletes everything you shared with any challenge, and the invite links you made, from the server. If you led a challenge, the member who has been in it longest takes over, unless they already lead one of their own. If you were the only member, the challenge is deleted.
- Switching phones: challenges don't move to a new phone. On the new phone, join again with an invite link. Your old phone stays in the team as a separate walker and keeps the streets it claimed, so your own share starts again on the new phone. To free its place, leave the challenge on the old phone before you stop using it, or, if you lead it, use Delete All Data there so another member takes over.
What your team sees
- Shared with your team: the name you chose to show the team, which streets in the challenge area you've walked, the day you first walked each one (not the time), and whether you marked it by hand. The app says so before you join, and again under "What the team sees" in the challenge's menu.
- Never shared: your GPS tracks, the routes of your walks, and anything outside the challenge area.
- Encrypted end to end: the key that unlocks a challenge lives on the team's phones. The server keeps a copy for each invite link, locked with a secret that is only in the link, after the "#". That part of a link is never sent to any server, so the server only ever holds data it can't read.
- No personal account: the app signs in with an anonymous identifier. No email, phone number, or password.
The privacy policy lists exactly what the server can and can't see.
Something not working?
- "Download [city] to see the team's progress": your walks in the challenge count once the city's map is on your phone.
- "Some streets can't count yet": your copy of the city was downloaded by an older version of the app. Refresh the city's map once.
- "This challenge needs a newer version": update CityWalker.
- The invite says it has expired or doesn't exist: ask a teammate for a new link.
- A challenge asks you to download a city you already have: some cities come in two versions in the city search, for example a Dutch town and the municipality around it. CityWalker matches either one, unless both are on your phone. Then remove the one you don't walk in, and the challenge finds the other.
- "Challenges aren't available in this version yet": update CityWalker. Challenges need Android 4.0 or iOS 2.0.
- On iPhone, a challenge says it no longer works (for example after restoring the phone): open an invite link for it again to get it back, or remove it from this phone.
Questions
Is it free?
Yes. Starting, joining and walking a challenge costs nothing.
Do we have to walk together?
No. Everyone walks whenever and wherever they like in the challenge area, and their streets add up on the team map. If you do walk together, one phone recording the walk is enough.
Is it a competition?
It's a team goal: the number that matters is the team's percentage. The challenge also shows how much each walker claimed, so you can see who found which streets, but there's no leaderboard.
Can my teammates see where I live or where I walk?
No. They see which streets in the challenge area you've walked and the day you first walked each one. Never your routes, your GPS tracks, the time of a walk, or anything outside the area. What your team sees has the details.
Can the leader remove someone?
Not yet; it's coming in an update. For now, a walker leaves with Leave challenge on their own phone, and the leader can delete the challenge and start a new one.
Does it work in any city?
Any city you've downloaded in full, and any city split into areas, either the whole city or one of its areas. A city you added with Just a small area can't host a challenge; it shows as “not available” until you download all of it.
What happens when the team reaches 100%?
The challenge stays as it is, with the full team map and 100% for everyone to look back on. Challenges have no end date. When you're done, the leader can delete it, which also lets them start a new one.
