A full-stack React 19 starter built with TanStack Start for type-safe routing and server rendering, using Vite+ as its toolchain and Ixia UI for components. Includes Better Auth, Drizzle ORM, theming, and English/Japanese internationalization.
- React 19 with the new React Compiler for automatic memoization
- TanStack Router — Type-safe file-based routing with SSR support
- TanStack Query — Powerful data fetching and caching
- TanStack Form — Type-safe form handling with server actions
- TanStack Table — Headless table utilities
- Ixia UI — Component library with light and dark themes
- Tailwind CSS v4 — Utility-first styling with the Vite plugin
- Shiki — Beautiful syntax highlighting with GitHub themes
- TanStack Start — Full-stack SSR framework powered by Nitro
- Better Auth — Secure authentication with session management
- Drizzle ORM — Type-safe database queries
- Neon DB — Serverless PostgreSQL database
- Paraglide — Compiled i18n with type-safe messages
- Pre-configured for English and Japanese
- Vite+ — Unified toolchain for development, builds, testing, linting, formatting, and Git hooks
- OXC — Lightning-fast formatting and linting (oxfmt + oxlint)
- Vitest — Fast unit and integration testing with Playwright browser tests
- Storybook 10 — Component development and visual testing
- Commitizen — Conventional commits with interactive prompts
- GitHub Actions — CI workflow for PRs (format, lint, test, build)
- Select Use this template above and create a repository under your GitHub account or organization.
- Clone the repository you just created and open it locally:
git clone https://github.com/<your-account>/<your-repository>.git
cd <your-repository>- Replace this starter's name, description, links, and branding with your own. Update
package.json, the README, and any deployment metadata that applies to your app. - Follow the setup steps below to configure your database and authentication.
For the button on this repository to work, its owner must open Settings > General and enable Template repository. After creating a copy, update the badge links to point to your repository.
Use create-ixia to scaffold a new app and choose which starter features to include. It prompts for a project name and lets you select features such as authentication, database integration, theming, localization, Storybook, and testing.
Requires Node.js 24 or newer:
pnpm create ixiaThen follow the prompts. When scaffolding completes, install dependencies and start the app:
cd my-ixia-app
vp install
vp dev- Node.js 24+
- pnpm (recommended) or npm/yarn/bun
- Sign up at neon.tech
- Create a new project
- Copy your connection string from the dashboard
cp .env-template .env.localEdit .env.local with your values:
# Database - Neon PostgreSQL
DATABASE_URL=postgresql://user:password@your-neon-host.neon.tech/dbname?sslmode=require
# Better Auth
BETTER_AUTH_URL=http://localhost:3000
BETTER_AUTH_SECRET=your-secret-here # Generate with: openssl rand -base64 32vp installGenerate and push the database schema:
vp run db:generate
vp run db:pushBetter Auth requires additional tables for users, sessions, and accounts. Generate them:
pnpm dlx auth@latest generateThis creates auth schema in src/db/. Then push to your database:
vp run db:pushThe .vite-hooks directory contains the hook definitions. Enable them once in each local clone to register the Vite+ dispatcher with Git:
vp hooks enablevp devOpen http://localhost:3000 in your browser.
| Command | Description |
|---|---|
vp dev |
Start the development server |
vp build |
Build for production |
vp preview |
Preview the production build |
vp test |
Run all tests |
vp check |
Format, lint, and type-check |
vp run storybook |
Start Storybook on port 6006 |
vp run db:studio |
Open Drizzle Studio |
vp run db:generate |
Generate database migrations |
vp run db:push |
Push schema changes to database |
vp run db:migrate |
Run database migrations |
src/
├── components/ # Shared UI components
├── db/ # Database schema and migrations
├── features/ # Feature-based modules
│ └── auth/ # Authentication feature
├── hooks/ # Custom React hooks
├── integrations/ # Third-party integrations
├── lib/ # Core utilities (auth, shiki, etc.)
├── middleware/ # Server middleware
├── paraglide/ # Generated i18n files
├── routes/ # File-based routes
│ ├── _secure/ # Protected routes (requires auth)
│ └── api/ # API routes
├── styles/ # Global styles
├── tests/ # Test setup and utilities
└── utils/ # Helper functions
This starter uses Better Auth with:
- Email/password authentication
- Username support
- Secure session management (7-day expiry, cookie caching)
- Protected routes via
_securelayout
Routes under src/routes/_secure/ are automatically protected. Users are redirected to /sign-in if not authenticated.
Ixia UI supports light and dark modes out of the box. The theme toggle component is pre-configured and persists user preference to localStorage.
Add or edit translations in messages/:
// messages/en.json
{
"auth.signIn.title": "Hello there!"
}Access translations in components:
import { m } from '#/paraglide/messages'
;<h1>{m['auth.signIn.title']()}</h1>- Create a feature branch
- Make your changes
- Commit using
pnpm commitfor conventional commits - Push and open a PR
Vite+ Git hooks run staged checks before commits, validate commit messages, and run checks, tests, and a production build before pushes.
If this starter saves you time, consider sponsoring its development on GitHub. Sponsorship helps fund ongoing maintenance and improvements.