README Template for React Projects

# Project Name

Brief description of what this app does.

## Demo

[Live demo](https://your-demo-url.com)

## Tech Stack

- React 19
- TypeScript
- Vite
- Tailwind CSS

## Getting Started

```bash
git clone https://github.com/your-username/your-project.git
cd your-project
npm install
npm run dev
```

Open [http://localhost:5173](http://localhost:5173) in your browser.

## Scripts

| Script | Description |
|--------|-------------|
| `npm run dev` | Start development server |
| `npm run build` | Build for production |
| `npm run preview` | Preview production build |
| `npm test` | Run tests |

## Project Structure

```
src/
  components/    # Reusable UI components
  hooks/         # Custom React hooks
  pages/         # Page-level components
  lib/           # Utility functions
  styles/        # Global styles
```

## Environment Variables

Create a `.env` file:

```
VITE_API_URL=https://api.example.com
```

## Contributing

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

## Licence

MIT