2.2 KiB
2.2 KiB
Mazane - Modern Admin Dashboard
A modern, responsive admin dashboard built with React, TypeScript, and Vite. This project provides a comprehensive solution for managing users, products, orders, and analytics.
Features
- 🎨 Modern and responsive UI with Tailwind CSS
- 📊 Interactive charts and analytics
- 👥 User management system
- 📦 Product management
- 🛍️ Order tracking
- 🔐 Authentication and authorization
- 🌙 Dark/Light mode
- 📱 Mobile responsive design
Tech Stack
- React 18
- TypeScript
- Vite
- Tailwind CSS
- React Query
- React Router
- Chart.js
- Zustand (State Management)
- React Hook Form
- Zod (Validation)
Getting Started
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
Installation
- Clone the repository:
git clone https://github.com/hosseintaromi/mazane.git
cd mazane
- Install dependencies:
npm install
# or
yarn install
- Start the development server:
npm run dev
# or
yarn dev
- Open http://localhost:5173 in your browser.
Project Structure
src/
├── components/ # Reusable UI components
├── contexts/ # React contexts
├── hooks/ # Custom React hooks
├── pages/ # Page components
├── services/ # API services
├── stores/ # State management
├── types/ # TypeScript types
└── utils/ # Utility functions
Available Scripts
npm run dev
- Start development servernpm run build
- Build for productionnpm run preview
- Preview production buildnpm run lint
- Run ESLintnpm run type-check
- Run TypeScript type checking
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'feat(feature): add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contact
Hossein Taromi - @hosseintaromi
Project Link: https://github.com/hosseintaromi/mazane