NNextbase

Documentation / Architecture

Platform

Architecture

Understand the TanStack, Convex, and trust boundaries.

Web application

TanStack Start renders public routes and TanStack Router owns route-level loading, metadata, and navigation. Authenticated screens resume after Convex Auth resolves in the browser.

Convex backend

Indexed queries provide reactive reads. Mutations enforce validation, tenancy, and roles at the function boundary rather than trusting the client.

External effects

Provider callbacks terminate at signed HTTP actions. Idempotency ledgers and durable workflows separate acknowledgement from retryable domain work.