Starter Kit for Vite, React, TypeScript, Tailwind and Node.js ESM

Minimal, sensible defaults, fast.

Read the blog post about this template.

Technologies

• Vite
• React with React Compiler enabled
• Relay for data fetching
• Tailwind
• fbtee for i18n
• Better Auth for authentication
• React Router
• TypeScript
• pnpm

Check out the nkzw-tech/server-template for a GraphQL based server with Pothos and Prisma, or the nkzw-tech/expo-app-template for building mobile apps.

Setup

• Press the "Use this template" button on the top of this repository's GitHub page.
• Run pnpm install (or npm install if you don't use pnpm).
• Run pnpm dev:setup.
• pnpm dev for development.
• Use pnpm test to run tests.
• pnpm build for production builds.

Note: You can install pnpm via homebrew on macOS: brew install pnpm.

Relay Setup

By default, this template expects the nkzw-tech/server-template to be located side-by-side with this repository. You can adjust the location of the GraphQL schema in your relay.config.js file.

Protips for the fastest Developer Experience

• Use npm-run-all2 to parallelize local test runs.
• Use oxlint for linting and oxfmt for formatting.
• Use swc with ts-node for fast node scripts with ESM. See below ↓

I'm not using Better Auth

You can simply remove everything related to Better Auth in the src/user directory.

Run node scripts with ESM and TypeScript, fast.

Create a script.ts file, run chmod x script.ts and execute it via ./script.ts.

#!/usr/bin/env node --no-warnings --experimental-specifier-resolution=node --loader ts-node/esm

console.log('Your code goes here.');

Use this to restart your scripts instantly when a file changes:

#!/usr/bin/env NODE_ENV=development node --watch --no-warnings --experimental-specifier-resolution=node --loader ts-node/esm

console.log('This processes instantly restarts when a file changes.');