# React App

Production-ready React starter with TypeScript, Vite, and essential libraries, generated by [StackKit](https://github.com/tariqul420/stackkit).

## Requirements

- Node.js 18+ (LTS recommended)
- pnpm (recommended) or npm

## Quick Start

Install dependencies and run the dev server:

```bash
# using pnpm (recommended)
pnpm install
pnpm dev

# or using npm
npm install
npm run dev
```

## Features

- React 19 with TypeScript
- Vite for fast development
- React Router for routing
- TanStack Query for data fetching
- Tailwind CSS for styling
- ESLint for code quality

## Scripts

| Command        | Description              |
| -------------- | ------------------------ |
| `pnpm dev`     | Start development server |
| `pnpm build`   | Build for production     |
| `pnpm preview` | Preview production build |
| `pnpm lint`    | Run ESLint               |

## Environment Variables

Copy `.env.example` to `.env` and configure local values. Do not commit secrets.

Example:

```env
VITE_API_URL=http://localhost:5000/api
```

## Folder Structure

```text
react-vite-app/
├── src/
│   ├── components/
│   │   ├── error-boundary.tsx
│   │   ├── layout.tsx
│   │   ├── seo.tsx
│   │   └── providers/
│   │       └── query-provider.tsx
│   ├── lib/
│   │   └── axios/
│   │       └── http.ts
│   ├── pages/
│   │   ├── about.tsx
│   │   ├── home.tsx
│   │   └── not-found.tsx
│   ├── types/
│   │   └── api.d.ts
│   ├── assets/
│   │   └── favicon.ico
│   ├── index.css
│   ├── main.tsx
│   ├── router.tsx
│   └── vite-env.d.ts
├── .env.example
├── .gitignore
├── .prettierrc
├── .prettierignore
├── eslint.config.js
├── index.html
├── package.json
├── tsconfig.json
├── tsconfig.app.json
├── tsconfig.node.json
└── vite.config.ts
```

## Deployment

Build for production and serve or deploy the static output:

```bash
# pnpm
pnpm build
pnpm preview

# npm
npm run build
npm run preview
```

Deploy the resulting `dist`/build output to your hosting platform (Vercel, Netlify, etc.).

---

Generated with [StackKit](https://github.com/tariqul420/stackkit) — `npx stackkit@latest create`