8000
Skip to content

redaezziani/namazi-store

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

UI Kit

Laravel Livewire TailwindCSS Redis SQLite PHP

A modern UI component library and e-commerce starter kit built with Laravel, React, and Tailwind CSS. UI Kit Cover

🌟 Overview

UI Kit is a comprehensive starter kit that combines Laravel's backend power with React's frontend flexibility. It includes a rich set of pre-built UI components, layouts, and pages to accelerate application development.

✨ Features

  • Modern Tech Stack: Laravel 12, React 19, TypeScript, Tailwind CSS 4
  • Component Library: 40+ reusable React components
  • Authentication: Full authentication system with password reset
  • E-commerce Ready: Product listings, cart, checkout, favorites
  • Dashboard Layout: Admin dashboard with analytics
  • Form Components: Input, Select, Checkbox, Radio, etc.
  • Theming: Light and dark mode support
  • Real-time Capabilities: WebSockets integration with Laravel Reverb
  • Mobile Responsive: All components work on mobile and desktop

πŸš€ Getting Started

Prerequisites

  • PHP 8.2+
  • Node.js 18+
  • Composer
  • SQLite or MySQL

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/ui-kit.git
cd ui-kit
  1. Install PHP dependencies:
composer install
  1. Install JavaScript dependencies:
npm install
  1. Copy the environment file:
cp .env.example .env
  1. Generate application key:
php artisan key:generate
  1. Create SQLite database (or configure MySQL in .env):
touch database/database.sqlite
  1. Run migrations:
php artisan migrate
  1. Start the development server:
npm run dev
# or with SSR
npm run dev:ssr

🧩 Components

UI Kit includes a wide range of components:

  • Layout Components: App Header, Sidebar, Navigation Menu
  • Form Components: Input, Select, Checkbox, Radio, etc.
  • Data Display: Table, Card, Badge
  • Feedback: Alert, Dialog, Toast
  • Navigation: Breadcrumb, Pagination
  • Overlays: Modal, Sheet (side panel), Dropdown
  • Media: Avatar, Image, Icon

πŸ“± Pages

The kit includes several pre-built pages:

  • Authentication: Login, Register, Forgot Password
  • E-commerce: Product Listings, Product Details, Cart, Checkout
  • Dashboard: Analytics, User Management
  • Settings: Profile, Password, Appearance
  • User: Favorites, Orders

🎨 Theming

UI Kit supports both light and dark themes, with a system preference option. Theme settings can be changed via:

  • Settings page
  • Theme toggle in the header

Themes are implemented using CSS variables, making customization straightforward.

⚑ Real-time Features

The project includes WebSocket integration with Laravel Reverb, providing real-time capabilities:

  • Real-time notifications
  • Live updates
  • Chat functionality (framework ready)

πŸ› οΈ Development Commands

# Start development server
npm run dev

# Start development server with SSR
npm run dev:ssr

# Build for production
npm run build

# Build for production with SSR
npm run build:ssr

# Lint code
npm run lint

# Type check
npm run types

# Format code
npm run format

πŸ“ Project Structure

ui-kit/
β”œβ”€β”€ app/                # Laravel backend code
β”œβ”€β”€ config/             # Laravel configuration
β”œβ”€β”€ database/           # Migrations and seeders
β”œβ”€β”€ public/             # Public assets
β”œβ”€β”€ resources/
β”‚   β”œβ”€β”€ css/            # CSS files (Tailwind)
β”‚   β”œβ”€β”€ js/
β”‚   β”‚   β”œβ”€β”€ components/ # React components
β”‚   β”‚   β”œβ”€β”€ hooks/      # Custom React hooks
β”‚   β”‚   β”œβ”€β”€ layouts/    # Page layouts
β”‚   β”‚   β”œβ”€β”€ lib/        # Utility functions
β”‚   β”‚   β”œβ”€β”€ pages/      # Page components
β”‚   β”‚   β”œβ”€β”€ stores/     # State management
β”‚   β”‚   └── types/      # TypeScript type definitions
β”‚   └── views/          # Blade templates
β”œβ”€β”€ routes/             # Laravel routes
└── vendor/             # Composer packages

🚒 Deployment

For production deployment:

  1. Install dependencies:
composer install --optimize-autoloader --no-dev
npm ci
  1. Build assets:
npm run build:ssr
  1. Optimize Laravel:
php artisan config:cache
php artisan route:cache
php artisan view:cache

πŸ“œ License

This project is licensed under the MIT License.

πŸ™ Acknowledgements

About

A modern UI component library and e-commerce starter kit built with Laravel, React, and Tailwind CSS.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

0