Warning

This boilerplate is still a work in progress and should not be used in production.

TanStack Boilerplate

A fully type-safe boilerplate with a focus on UX and DX, complete with multiple examples.

Tech Stack

• React 19
• React Compiler
• TanStack Start
• TanStack Router
• TanStack Query
• TanStack Form
• TanStack Virtual
• Better Auth
• Tailwind CSS
• Shadcn UI
• Prisma
• Zod
• next-intl core library
• Nodemailer + React Email

Utilities

• Theme - A next-themes-like API that integrates seamlessly with TanStack Start.
• Custom Logger - A visually appealing logger compatible with both browser and Node environments.
• File Upload (TODO) - Supports file uploads to any object storage service with a S3-compatible API.
• Environment Variable Validation - Type-safe, runtime validation of environment variables for a more secure configuration.

Issues or Pull Requests Tracking List

• Start
  • HMR
    • TanStack/router#2316
  • Server functions can't serialize error objects
    • TanStack/router#2535
  • Start: createServerFn cannot return raw response objects
    • TanStack/router#2779
  • Flash of Unstyled Content for quickstart plus a CSS file
    • TanStack/router#2700
• Router
  • Router optional params for i18n
    • TanStack/router#146 (comment)
• Virtual
  • Compatibility with the React compiler
    • TanStack/virtual#736
    • TanStack/virtual#851
• Vinxi
  • Environment variables not loaded in production
    • nksaraf/vinxi#277
    • nitrojs/nitro#1492
    • node --env-file=.env .\.output\server\index.mjs
  • Auto reload dev server when .env changes
    • nksaraf/vinxi#345
  • No valid compatibility date is specified
    • solidjs/solid-start#1670
    • nitrojs/nitro#2511
    • https://github.com/unjs/compatx/blob/main/RFC.md
• ESLint
  • Tailwindcss Plugin
    • no-multiple-whitespace rule
      • francoismassart/eslint-plugin-tailwindcss#370