An open API service indexing awesome lists of open source software.

https://github.com/rohancyberops/shadcn


https://github.com/rohancyberops/shadcn

Last synced: 12 months ago
JSON representation

Awesome Lists containing this project

README

          

# Modern React + Vite Starter

A production-ready React starter template powered by Vite, featuring a modern tech stack and comprehensive UI components from shadcn/ui.

![React](https://img.shields.io/badge/React-18.3-blue)
![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)
![Vite](https://img.shields.io/badge/Vite-5.4-blue)
![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-3.4-blue)

## Features

- ⚡️ **Lightning Fast**: Built on Vite for rapid development and optimized builds
- 🎨 **Beautiful UI**: Integrated shadcn/ui components with Tailwind CSS
- 📦 **Type Safe**: Full TypeScript support with strict mode enabled
- 🔧 **Developer Experience**: ESLint configuration for code quality
- 🎯 **Production Ready**: Optimized build setup with best practices
- 🎭 **Dark Mode**: Built-in dark mode support
- 📱 **Responsive**: Mobile-first design approach

## Quick Start

```bash
# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview
```

## Tech Stack

- **Framework**: React 18 with TypeScript
- **Build Tool**: Vite
- **Styling**: Tailwind CSS
- **UI Components**: shadcn/ui
- **Icons**: Lucide React
- **Form Handling**: React Hook Form
- **Date Handling**: date-fns
- **Charts**: Recharts
- **Animations**: Tailwind CSS Animate

## Project Structure

```
src/
├── components/ # UI components
│ └── ui/ # shadcn/ui components
├── hooks/ # Custom React hooks
├── lib/ # Utility functions
└── App.tsx # Main application component
```

## Development

### Code Style

- Follow TypeScript best practices
- Use functional components with hooks
- Maintain consistent file and folder naming
- Write clean, self-documenting code

### Best Practices

- Keep components small and focused
- Use TypeScript types for props and state
- Implement proper error handling
- Follow React performance optimization guidelines

## Building for Production

```bash
npm run build
```

This will create an optimized production build in the `dist` directory.

## License

MIT

## Contributing

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