# react-ts-template-25

**Repository Path**: diogoxiang/react-ts-template-25

## Basic Information

- **Project Name**: react-ts-template-25
- **Description**: React TypeScript Template 2025
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2025-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: React, TypeScript

## README

#React TypeScript Template 2025

## ✨ Features

- **React 19** - Latest React with concurrent features
- **TypeScript 5.7** - Full type safety with latest features
- **Vite 6** - Lightning fast build tool with HMR
- **Tailwind CSS** - Utility-first CSS framework with custom design system
- **Radix UI** - Accessible, unstyled UI components
- **TanStack Query** - Powerful data fetching and caching
- **TanStack Router** - Type-safe routing
- **Zustand** - Lightweight state management
- **React Hook Form + Zod** - Type-safe forms with validation
- **Vitest** - Fast unit testing with coverage
- **ESLint + Prettier** - Code linting and formatting
- **Husky + lint-staged** - Git hooks for code quality

## 🚀 Getting Started

### Prerequisites

Make sure you have the following installed:
- **Node.js** >= 18.0.0
- **npm** >= 9.0.0 (or **yarn** >= 1.22.0, **pnpm** >= 8.0.0)

### Quick Start

1. **Clone this template:**
   ```bash
   git clone <your-repo-url>
   cd react-ts-template-2025
   ```

2. **Install dependencies:**
   ```bash
   npm install
   # or
   yarn install
   # or
   pnpm install
   ```

3. **Start development server:**
   ```bash
   npm run dev
   # or
   yarn dev
   # or
   pnpm dev
   ```

4. **Open your browser:**
   Visit [http://localhost:3000](http://localhost:3000)


## 📁 Project Structure

```
src/
├── components/          # Reusable UI components
│   └── ui/             # Base UI components (buttons, cards, etc.)
├── pages/              # Page components
├── hooks/              # Custom React hooks
├── utils/              # Utility functions
├── types/              # TypeScript type definitions
├── assets/             # Static assets
├── test/               # Test utilities and setup
├── lib/                # Library configurations
├── App.tsx             # Main App component
├── main.tsx            # Application entry point
└── index.css           # Global styles
```

## 🛠️ Available Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run preview` - Preview production build
- `npm run test` - Run tests
- `npm run test:ui` - Run tests with UI
- `npm run test:coverage` - Run tests with coverage
- `npm run lint` - Lint code
- `npm run lint:fix` - Fix linting issues
- `npm run format` - Format code with Prettier
- `npm run typecheck` - Check TypeScript types