Architecture overview

Fernwaerts is a local-first app. Your phone does the day-to-day work, and the self-hosted server keeps a durable, synchronized copy of your data.

What your phone does

Your phone is the main engine for your location history. It records your locations and keeps a local copy of your history. From that data it builds the movement segments, places, map, and timeline you see in the app, detecting movement and reverse geocoding places along the way.

What the server does

The self-hosted server provides authentication and a durable copy of your data, so your history can persist and stay synchronized across multiple devices. It is not the main processing engine for your location history.

Keeping everyday processing on the phone also leaves room for a future version of Fernwaerts that works entirely locally, without a self-hosted server.

How data moves

Fernwaerts appRecords and processes your location history

SupabaseReceives writes and handles authentication

PostgreSQLStores the durable server copy

PowerSyncSyncs server data into the app's local copy

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.