中文 | 日本語 | Русский язык

A production-ready React template optimized for building modern web applications with TanStack ecosystem tools. This template provides a complete foundation including state management, routing, data fetching, and build optimization out of the box.

• Modern React Architecture: Built with React 19.x for component-driven development
• Comprehensive State Management: Server state: @tanstack/react-query for caching, background updates, and data synchronization
• Advanced Routing: @tanstack/react-router for type-safe client-side navigation with nested routes support
• Optimized Styling: Tailwind CSS for utility-first styling with minimal configuration
• Type Safety: Full TypeScript integration throughout the codebase
• Performance Optimization: Built-in code splitting and lazy loading; Optimized bundle size with Rsbuild
• Developer Experience: Fast refresh during development
• CI/CD Ready: GitHub Actions workflow for automated testing and releases
• Internationalization: Structure for multi-language support
• Production-Ready: Optimized build process and best practices implementation

Pushing a version tag matching v* runs .github/workflows/pages.yml, which builds with BASE_PATH=/<repository-name>/, copies dist/index.html to dist/404.html for SPA routing, and deploys to GitHub Pages. In the repository Settings → Pages, set Source to GitHub Actions once.

BASE_PATH=/react-tanstack/ pnpm run build && pnpm preview

PowerShell:

$env:BASE_PATH="/react-tanstack/"; pnpm run build; pnpm preview

• Framework: React 19.x
• Type System: TypeScript 5.x
• State Management: @tanstack/react-query
• Routing: @tanstack/react-router
• Styling: Tailwind CSS
• Build Tool: Rsbuild
• Linting: ESLint with @antfu/eslint-config
• Package Manager: pnpm

See the package.json for a full list of dependencies.

Follow these instructions to get the project running locally.

Ensure you have the following installed:

• Node.js (>= 18.x recommended)
• Package manager (npm, yarn, or pnpm)

node -v
npm -v

Run script

pnpm create trapar-waves

Install dependencies

npm install
yarn install
pnpm install

Contributions are welcome and greatly appreciated! Please follow these steps to contribute:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please ensure your code follows the project's coding standards and passes all tests before submitting a PR.

• Rikka: admin@rikka.cc
• GitHub Profile: Muromi-Rikka

This project is licensed under the MIT License - see the LICENSE file for details.

• Repository: https://github.com/Trapar-waves/react-tanstack
• Homepage: https://github.com/Trapar-waves/react-tanstack
• Issues: https://github.com/Trapar-waves/react-tanstack/issues