CronZeno Online Features

Introduction & Philosophy
Account & Login
Role System
Publishing Racetracks
Publishing Races
1. Public Races
2. Restricted (Team) Races
Contributing to a Race
Leaderboard
Browsing Online Content
Privacy & Data
FAQ

1. Introduction & Philosophy

CronZeno has always been an offline-first app: your races, tracks, and GPS logs live on your device and work without any internet connection. Version 1.2.9 adds an entirely optional online layer powered by Supabase, letting you share what you want, when you want.

Nothing is uploaded automatically. Every publish action is explicit — you decide which racetracks and races go online, and you can unpublish them at any time.

The online features are designed around three core activities:

Share Racetracks

Publish a course so other athletes can download and use it

Any user can publish a racetrack (course definition, sectors, optional GPX route) to the public library. Others can browse and download it with one tap.

Publish Race Events

Create an official event that athletes can join and submit their runs to

Team Managers and Race Masters can publish race events. Athletes join by uploading their run result. The app automatically calculates rankings and displays a live leaderboard.

Compete on Leaderboards

See how you rank against other athletes on the same course

Every published race has a live leaderboard showing position, total time, average speed, and category/country/team chips for each athlete.

2. Account & Login

Online features require a free CronZeno account. Registration uses email + password with a secure PKCE flow (no third-party logins required).

How to create an account

Open the app and go to the Profile tab(bottom navigation, person icon).
Tap “Sign In / Register”and choose “Create account”.
Enter your email and a password(min. 8 characters).
Confirm your emailvia the link sent to your inbox.
Complete your profile: display name, country, team code (optional).

You can use all local features (record GPS tracks, manage races, analyse performance) without an account. An account is only needed to use online features.

Profile & athlete details

Your profile stores the information that appears on leaderboards: athlete name, country code, team code, age, and category. Fill these in before submitting runs to races so your entry displays correctly to other users.

3. Role System

CronZeno Online uses a three-level cumulative role system. Roles are earned by peer endorsement — no administrator approval is needed.

Athlete

Default role — granted on registration

Publish & manage own racetracks
Browse and download public racetracks
Browse public and team-restricted races
Submit a run to any public race or a race owned by their Team Manager
View leaderboards

Team Manager

Earned when 2+ athletes confirm your team alias

Everything an Athlete can do
Publish team-restricted races (visible only to team members)
Invite athletes to the team
Endorse Race Master candidates

Race Master

Earned when 2+ Team Managers approve your endorsement request

Everything a Team Manager can do
Publish public races (visible to everyone)
Choose visibility at publish time: public or team-restricted

Roles are cumulative. A Race Master is also a Team Manager and an Athlete. Earning a higher role never removes the lower-level permissions.

How to become a Team Manager

The Team Manager role is granted automatically by the system when at least two athletes confirm you as their team alias. This works through the same alias/team-code flow already used in the app:

Set a team codein your profile (e.g.,ALPISKI).
Share your team codewith athletes in your team.
Each athlete enters your team codein their profile and confirms membership.
Once 2 athletes have confirmed, your account is automatically upgraded to Team Manager.

How to become a Race Master

The Race Master role requires endorsement from at least two Team Managers:

Go to your Profile → Race Master section.
Send endorsement requeststo Team Managers you know.
Each Team Manager reviews and acceptsvia their own profile screen.
Once 2 endorsements are accepted, you become a Race Master automatically.

Endorsement requests can be cancelled or rejected. If a Team Manager loses their role, endorsements they gave remain valid.

Role summary table

Action	Athlete	Team Manager	Race Master
Publish racetrack (public)	✅	✅	✅
Download racetrack	✅	✅	✅
Submit run to a race	✅	✅	✅
View leaderboard	✅	✅	✅
Publish team-restricted race	❌	✅	✅
Publish public race	❌	❌	✅
Endorse Race Master candidates	❌	✅	✅

4. Publishing Racetracks

Any registered athlete can publish a racetrack to the shared online library. A published racetrack includes its name, description, sport type, location tag, sector definitions, and — if present — the GPX route file.

How to publish a racetrack

Open the Tracks taband tap the racetrack you want to share.
Tap the cloud icon(blue) in the top-right of the racetrack detail screen. If you are not logged in, you will be prompted to sign in first.
Confirm the publish action.The app uploads the racetrack metadata and GPX file (if any) to the CronZeno cloud.
The cloud icon turns solid blueto indicate the track is now public. A cloud badge also appears on the track card in the Tracks list.

Unpublishing is instant. Tap the cloud icon again and confirm to remove the racetrack from the public library. Existing downloads by other users are not affected.

What other users see

Published racetracks appear in the Browse Online → Racetracks section. Other athletes can:

Filter by sport type, location, or name
Preview the route on an interactive map
Download the racetrack (including the GPX file) with one tap — it is saved locally just like a manually created track

GPX storage

GPX files are stored in a private Supabase Storage. Only authenticated users can read files; anonymous access is not permitted.

5. Publishing Races

A published race is an official event on the CronZeno platform. Athletes can find it, add their own run results to it, and compare times on the leaderboard.

Publishing a race requires at least Team Manager role. Athletes can submit runs to existing races, but cannot create new online race events.

5a. Public Races

A public race is visible to every CronZeno user and appears on the CronZeno website. Only Race Masters can publish public races.

Open the racein the Races tab and tap “Edit / Publish”.
Tap the blue cloud-upload button.
Choose “Public”from the visibility dialog (this option only appears for Race Masters).
Confirm.The race, all associated runs, and aggregate results are uploaded. The app calculates and upserts positions.

5b. Restricted (Team) Races

A team-restricted race is visible only to members of the owner’s team. It does not appear on the public website. Team Managers and Race Masters can publish restricted races.

Follow steps 1–2 above.
Choose “Team only”in the visibility dialog.
Confirm.The race is uploaded withis_public = false.

Restricted races show an orange lock icon in the race list. Only users whose team code matches the owner’s team can see and access them — this is enforced at the database level via Row Level Security, not just the UI.

Unpublishing a race

The owner can unpublish a race at any time from the same Publish button (it becomes an Unpublish action once the race is online). Unpublishing removes the race from the online listings but does not delete local data on any device.

What is uploaded

Data	Notes
Race metadata (name, dates, laps, status)	Owner’s copy
Racetrack reference	Links to published track
Run metadata + stats	No raw route points
GPX file per run	Full GPS track
Aggregate results	Includes rankings
Sector split times	No raw route points

6. Contributing to a Race

Any Athlete can add their run to a race that has already been published by someone else. This is how multi-athlete leaderboards are built: one person publishes the event, others contribute their individual runs.

How to submit your run

Browse Online → Racesand find the race you participated in.
Download the raceto your device (if you don’t have it locally).
Record your runlocally using the Record tab, on the same racetrack.
Open the race, then tap “Publish” / “Add my run”.The app detects you are not the race owner and automatically uploads only your new run(s).
The leaderboard is updated automatically— positions are recalculated and upserted in real time.

The app checks which runs belong to the logged-in user (athleteUserId == currentUserId) and only uploads those — you cannot modify other athletes’ runs.

Athlete profile on the leaderboard

Your leaderboard entry displays the information from your profile at the time of upload: athlete name, country flag, team code, category, and age. Update your profile before submitting if you want accurate information shown.

7. Leaderboard

The leaderboard shows all submitted runs for a race, sorted by position (fastest first). It is accessible from both the app and the CronZeno website.

Reading the leaderboard

Column	Description
Position	Rank (1 = fastest). Ties show the same position.
Athlete	Display name from profile, with country flag and team chip
Total time	Elapsed time for the full race distance (h:mm:ss)
Avg speed	Average speed in km/h over the full run
Category	Athlete category chip (if set in profile)

Podium display

The top 3 results are highlighted with a podium layout: gold (1st), silver (2nd), bronze (3rd) backgrounds with enlarged athlete cards.

Accessing the leaderboard

In the app: open a published race → tap “View Leaderboard” (outline button, blue).
On the website: browse to cronzeno.com/online, find the race, and click the leaderboard icon.

Pull down to refresh the leaderboard in the app. New submissions appear within seconds.

8. Browsing Online Content

The Browse Online feature lets you discover and download racetracks and races shared by the community.

Accessing Browse Online

In the app, a small blue cloud FAB appears above the main green “+” button on the Races tab and the Tracks tab. Tap it to open the online browser.

Browsing Racetracks

Search by name, sport type, or location
Each card shows: name, sport type badge, location, number of sectors
Tap a card to preview the route map and see full details
Tap Download to save it locally — it becomes available immediately in your Tracks tab
If you already have the track locally, the button shows “Already saved” and is disabled

Browsing Races

Lists all races visible to you: public races + restricted races you are a team member of
Restricted races show an Team only chip
Tap Download to save the full race locally (including runs, results, and racetrack)
Once downloaded, you can record your own run locally and then upload it back

Browsing requires an internet connection. Once downloaded, all race and track data is fully available offline.

9. Privacy & Data

CronZeno is designed with privacy as a first principle. Here is exactly what happens with your data:

Data type	Where stored	Who can see it
Local races, tracks, GPS recordings	Your device only	You only — never uploaded automatically
Published racetrack metadata	CronZeno cloud (Supabase)	All registered users (public) or team members (restricted)
Published race metadata & results	CronZeno cloud (Supabase)	All users (public) or team members only (restricted)
GPX files (run routes)	Supabase Storage (private bucket)	Authenticated users only; same visibility rules as the race
Profile info (name, country, team)	CronZeno cloud	Visible on leaderboards of races you participate in
Email address	Supabase Auth (encrypted)	Only you — never displayed to other users

Row Level Security (RLS)

All data access is enforced at the database level using Supabase Row Level Security. The app UI respects these rules, but even a direct API call cannot bypass them — the database rejects unauthorized requests.

Deleting your data

You can unpublish any racetrack or race at any time. To request full account deletion (including all cloud data), contact support via the CronZeno website.

10. FAQ

Do I need an account to use CronZeno?

No. All local features — GPS recording, race management, performance analysis — work without an account. An account is only needed for online features.

Is the online feature free?

Yes. The online features in version 1.2.9 are free for all users.

What happens if I publish a race and someone downloads it — do I lose control?

No. You remain the owner. Other users can download a copy to their device, but they cannot modify the original online race. Only you can unpublish or modify the online record.

Can an Athlete submit a run to any race?

An Athlete can submit runs to public races (visible to everyone) and to team-restricted races owned by their Team Manager. They cannot submit to restricted races owned by managers outside their team.

What sport types are supported?

CronZeno supports any GPS-based sport. Common types include running, cycling, skiing, trail running, and triathlon. The sport type field is free text, but using standard names improves discoverability in the online browser.

Are leaderboard positions recalculated when new runs are added?

Yes. Every time a new run is submitted to a race, the app recalculates all positions and upserts the full results table. The leaderboard reflects the latest state within seconds.

I don’t have internet during the race — does that matter?

Not at all. Record your run offline as usual. Upload it to the online race when you have connectivity — there is no time limit on contributing to an open race event.

How do I report abusive content or invalid results?

Use the feedback form on cronzeno.com. Race owners can unpublish a race at any time. Administrators can remove content via the admin dashboard.