Go to file
hosseintaromi f43e7ca0e5 feat(navigation): integrate roles into app navigation
- Add all roles routes to App.tsx
- Add roles menu item to sidebar with Shield icon
- Update user display to use AdminUser properties
- Fix TypeScript compatibility issues with new auth types
2025-07-18 14:03:07 +03:30
dist Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
src feat(navigation): integrate roles into app navigation 2025-07-18 14:03:07 +03:30
.gitignore Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
Dockerfile Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
README.md Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
docker-compose.stage.yml add docker-compose for stage 2025-07-13 20:05:16 +00:00
docker-compose.yml Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
index.html Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
nginx.conf Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
package-lock.json Update package dependencies to include js-cookie and its type definitions 2025-07-18 12:49:14 +03:30
package.json Update package dependencies to include js-cookie and its type definitions 2025-07-18 12:49:14 +03:30
postcss.config.js Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
swagger.json Add swagger.json for API documentation and define admin routes 2025-07-18 12:49:20 +03:30
tailwind.config.js Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
tsconfig.json Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
tsconfig.node.json Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30
vite.config.ts Update file structure and improve code organization in the main directory 2025-07-13 22:03:22 +03:30

README.md

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

  1. Clone the repository:
git clone https://github.com/hosseintaromi/mazane.git
cd mazane
  1. Install dependencies:
npm install
# or
yarn install
  1. Start the development server:
npm run dev
# or
yarn dev
  1. 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 server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint
  • npm run type-check - Run TypeScript type checking

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat(feature): add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. 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