Fumadocs on TanStack Start

Access denied on Maintenance or Work Order

Symptoms: Red Access denied panel mentioning Maintenance or Work Order.

Check:

Select the correct organization and group in the header (see Groups).
Ask your administrator for view_alert or manage_alert (maintenance paths) or view_vehicle or list_vehicle (work-order paths). Details in Access & permissions.

I cannot find Maintenance in the sidebar

Explanation: The default sidebar layout reviewed does not include Maintenance or Work Order entries. Use a direct URL or an internal link from your organization.

Issue or incident detail shows “not found”

Causes:

The id in the URL is not present in the sample dataset your build loads.
You bookmarked an id from another environment.

What to do: Open the list page and click a row to navigate with a valid id, or confirm with your administrator if production uses API-backed loaders.

Approve / Reject / Manage on detail pages does nothing

Explanation: On issue and incident detail pages, those controls are not connected to handlers in the reviewed sass-console code.

What to do: Use list dialogs for edits where available, or wait for a build that wires approvals to your backend.

Refuel “New Work Order” has no form

Explanation: The refuel route sets open state but does not mount a modal in the reviewed file.

What to do: Use Service work orders for the add-dialog reference, or track refuel orders through your organization’s supported workflow.

Service task delete shows toast but data comes back on refresh

Explanation: Service tasks use generated mock data in a useMemo with an empty dependency array; deletes only trigger a toast in the reviewed route.

What to do: Treat service tasks as UI preview unless your deployment replaces mocks with APIs.

Public `/v` links expose data

Explanation: Public routes use mock data and no login check in the reviewed routes.

What to do: Do not share /v links unless your security team confirms they are safe on your deployment (authentication, tokenized URLs, network rules).

Vehicle tabs for issues or work orders are missing

Explanation: Links to /dashboard/fleet-management/vehicles/:vehicleId/incidents and .../work-order exist as routes, but the tab buttons are commented out in the vehicle detail layout in the reviewed code.

What to do: Navigate via maintenance or work-order URLs, or ask your administrator when vehicle tabs will be enabled.

Troubleshooting