skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
fixmyberlin/fixmyskills52 installs

tanstack-start-conventions

TanStack Start conventions for FixMyBerlin/FMC: app folder layout, thin routes, client/server file suffixes, createServerFn, selective SSR, experimental RSC, and API route param/search validation. Requires tanstack-router-conventions for validateSearch, search serialization, and loader + Query patterns. Use when scaffolding or refactoring Start apps, server functions, SSR, renderServerComponent, or API routes under routes/api/.

How do I install this agent skill?

npx skills add https://github.com/fixmyberlin/fixmyskills --skill tanstack-start-conventions
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    Architectural guidance and conventions for building TanStack Start applications, emphasizing server/client isolation, SSR modes, and Zod validation. The skill follows security best practices for data handling and environment isolation.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

TanStack Start conventions

Stack conventions for TanStack Start apps in this org. Requires skill tanstack-router-conventions (search params, pretty URLs, loaders + Query, form vs useMutation, typed Router TS, devtools) - do not duplicate it here. Pair with tanstack-start-auth for auth and session layout.

Which reference to read

TaskFile
Scaffold or refactor app/src folders, thin routes, Layout/Page naming, testsapp-structure.md
Split code between .server.ts / .functions.ts, import protection, beforeLoad vs loader, error loggingclient-server-boundaries.md
Write createServerFn, validation, form submit, invalidationserver-functions.md
Loader or component hits DB/fs/secrets, client-nav bugsexecution-model.md
Set route ssr, debug SSR / hydration, Query dehydrationselective-ssr.md
API route under routes/api/ (path params, search, POST body)params-search-api-routes.md
Experimental RSC (renderServerComponent, createCompositeComponent)server-components.md
bun --bun for Vite + Nitro scriptslocal-runtime.md

Auth flows: skill tanstack-start-auth.

Non-negotiable rules

TopicRule
Server-only modules*.server.ts - never imported by routes/components (exceptions: routes/api/ and handler-only routes without a component); use createServerOnlyFn inside
Callable from client*.functions.ts with createServerFn; name exports *Fn
Public server fnspublic*.functions.ts - no global auth middleware; rate-limit/token checks in .server.ts (see tanstack-start-auth)
API route filesNo server-only import marker on the route file; server-only logic inside handlers or tree-shaken imports
API search paramsNo validateSearch on API routes; Zod safeParse in GET from request.url, return 400 JSON on failure
SSRSet ssr explicitly on every route; UI default true; handler-only API routes false; map-heavy UI 'data-only'
Local Bun runtimeVite dev and Nitro start/preview use bun --bun
Router search / QueryOwned by tanstack-router-conventions (parseSearch / stringifySearch, loader + Query)

Quick decisions

  • beforeLoad vs loader: redirects, auth, light context in beforeLoad (not middleware); data fetch / Query priming in loader. beforeLoad re-runs on every navigation, search-param changes included, so hot routes (map viewport, layer toggles) put redirect/auth/region in the loader and keep those params out of loaderDeps. Details: client-server-boundaries.md.
  • Loader vs Query, form vs mutation: follow tanstack-router-conventions -> references/router-and-query.md (#client-mutations). On Start, loaders and mutationFn call the *Fn; server I/O always goes through createServerFn.
  • ssr: map/canvas-heavy UI needing server auth/data -> 'data-only'; handler-only API (server.handlers) -> false; fully client-first UI route -> false (rare).
  • Server components: opt-in experimental, not the default FMC data path.

Related skills

TopicSkill
Router (required)tanstack-router-conventions
Auth / sessiontanstack-start-auth
Bun install / nvmtech-stack -> bun-install
Zustandzustand-state-management
URL state without TanStack Routernuqs
Leftover placement after refactorsunslop-code Phase 6 -> references/component-location.md

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/fixmyberlin/fixmyskills/tanstack-start-conventions">View tanstack-start-conventions on skillZs</a>