Understand Project Structure

Find the change you want in this map, then open its edit point. Paths begin at your cloned Start repository.

Navigate native routes

src/routes/__root.tsx renders the document and shared providers. A folder's route.tsx wraps its children; index.tsx renders its base URL. _marketing groups public pages without adding a URL segment. $projectId matches one segment; $ is a catch-all. TanStack Router generates src/routeTree.gen.ts from these files. Edit the route files rather than the generated tree; see file-based routing.

The authenticated Dashboard parent calls src/lib/dashboard.server.ts before rendering its shell. /demo/dashboard has a separate public parent and sample data. Put protected pages under the authenticated route tree; sharing a UI component with the demo does not make its data public.

Place server work

src/routes/api/$.ts mounts Hono on /api/*. Browser components use hooks calling that same-origin API. Services make product decisions; repositories read or write application tables. Add a business endpoint in those existing layers rather than creating another runtime.

Route components participate in server rendering and browser navigation. Keep privileged imports inside server-function handlers or modules marked @tanstack/react-start/server-only. Narrow Start server functions handle route bootstrap, language preference, feedback and authorized content rendering. They do not replace the Hono domain API.

src/router.tsx supplies the QueryClient and SSR integration. src/start.ts supplies request middleware, session refresh and server-function CSRF. Use Application Architecture before changing these shared entry points.

Find content and build configuration

source.config.ts declares MDX collections. src/lib/docs.server.tsx and src/lib/blog.server.tsx load and render content at the server boundary. mdx-components.tsx supplies the MDX component registry. Use the native content guides when changing routes or rendering; ordinary MDX authoring stays in the shared documentation.

vite.config.ts connects Start, React, Fumadocs, Tailwind and Nitro. package.json owns development and build commands; bun.lock locks the root dependency graph used by the app and E2E directories.

What's next