Fumadocs on TanStack Start

Create, search, edit, and delete organization addresses with map-backed coordinates (production).

Saved addresses are reusable locations (for example depots or handoff points) with coordinates stored for the tenant. This module is production-backed.

Navigation: Settings → General Settings → Address Setting (/dashboard/setting/general-settings/address-setting).

Permissions

create_address, update_address, and delete_address gate Add Address, Edit, and Delete. See Access and permissions.

Main screen layout

Header — title, Search, Filter, and Add Address (when allowed).
Left panel — scrollable cards for each address; select a card to focus the map.
Right panel — map with markers for all addresses that have coordinates.

Search

Type in Search; the list debounces and queries the server with your text. Empty state messages distinguish no matches from no addresses yet.

Add address

Steps

Select Add Address.
Enter Name (required).
Optionally enter Description.
Choose Status (required; from object_status lookups).
Open the map picker, select a point, and confirm so latitude and longitude are set.
Submit Add / save.

Validation

Name and Status are required.
Location is required if latitude or longitude is missing (map selection not completed).

Expected result: Success toast, dialog closes, list and map markers refresh.

Edit address

Steps

On an address card, open the ⋯ menu and choose Edit (update_address).
Change name, description, status, and/or pick a new map location.
Save.

Delete address

From the card menu, choose Delete (delete_address), then confirm. The record is removed on success.

Map interaction

Selecting a card centers the map on that address (higher zoom when a selection exists).
Coordinates in the API are stored as [longitude, latitude]; the UI shows formatted values on cards.

Error and empty states

Failed to load addresses: Use Retry when shown.
No coordinates on a card means the record cannot place a marker until edited with a map point.

Troubleshooting

Location is required: Open the map modal, pick a point, and save the selection before submitting the form.
Actions missing from menu: Confirm update_address / delete_address on your role.
Search returns nothing: Widen or clear the query; verify addresses were created in this organization context.

Route fence — uses address records as source and destination.
Geofence
Troubleshooting

Address setting